Re: film score example

[Trevor Daniels]

David Kastrup wrote Friday, September 13, 2013 3:03 PM

> Sometimes the effort is better spent simplifying the underlying concepts
> and documenting the results.  One hits diminuishing returns pretty fast
> when trying to simplify the explanation of complex matters.
> 
> I think when I tried starting to augment LilyPond's documentation about
> its programming models, I got into a bad mood rather fast.  It was like
> writing a driver's manual of the kind:
> 
>    "To make a right turn, you stick together the blue wire under the
>    passenger seat and the black wire sticking out from the speedometer.
>    The black wire is not obligatory, you can touch any blank part of
>    the car's chassis instead once you scrape it open.  This will set
>    the turn signal.  The turn itself is done as customary using the
>    handlebar.  Power steering is available by pulling on the wire
>    coming off the speedometer though it inverts the direction of the
>    handlebar.  We suggest holding the wire in your teeth in order not
>    to have to fumble for it."
> 
> Of course, you had to talk to the engineers and dig through the
> blueprints to figure out all that.

LOL!  That brings back memories of my early attempts at discovering
how things worked before attempting to write documentation!

Trevor