Re: MIDI::Score

At 04:07 PM 2003-05-25 +0000, Dave Turner wrote:
>>>Thanks Sean, but remember, Monkey See Monkey Do.
>>>Leave 4 lines of code out of your POD and it gives Perl newbies like me 
>>>a real headache!
>>Huhwhat?  Four lines what where?
>look at MIDI::Score. [...] but you don't tell us HOW to do it!

Writing documentation is a matter of looking at the infinite regress of 
constituent detail and required knowedge, and saying "I will stop 
/here/.  I will assume that the 'notional reader' know all the things up to 
here, and none of the things past here".  With MIDI::Score, the notional 
reader that I wrote the docs for, is comfortable getting and dealing with 
event structures.  That was an arbitrary decision on my part.

--
Sean M. Burke    http://search.cpan.org/~sburke/