Re: [Bug 20254] Add code examples

On Monday, December 10, 2012, 8:55:54 PM, bugzilla wrote:

bjwo> https://www.w3.org/Bugs/Public/show_bug.cgi?id=20254

bjwo> --- Comment #7 from Florian Bomers <w3c_bugz@bome.com> ---
bjwo> (In reply to comment #6)

bjwo> thanks for the super fast changes!

>> https://dvcs.w3.org/hg/audio/rev/d61cc0adee7e

bjwo> includes the following addition:

bjwo> "This example sends a middle C note on message immediately on MIDI channel 0
bjwo> [...]"

bjwo> I'm sure you are aware of this -- MIDI channels are encoded as the lower 4 bits
bjwo> of the status byte from 0 to 15. But when referring to them, by convention,
bjwo> they are numbered 1 to 16. Therefore, I think it's better to change the text to
bjwo> say "MIDI channel 1".

I agree.

Actually there is no ambiguity with channel 1 (channel byte 0). But in general for channel n its important to know if this is 0-based or 1-based.

Given that the target audience for users is accustomed to a 1-based notation, that is what the spec should use.

And given that the target audience for implementors will assume a 0-based notation, the convention should be explicitly called out otherwise they will get it wrong.



-- 
 Chris Lilley   Technical Director, Interaction Domain                 
 W3C Graphics Activity Lead, Fonts Activity Lead
 Co-Chair, W3C Hypertext CG
 Member, CSS, WebFonts, SVG Working Groups

Received on Monday, 10 December 2012 21:41:39 UTC