[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: film score example
From: |
Trevor Daniels |
Subject: |
Re: film score example |
Date: |
Fri, 13 Sep 2013 16:12:08 +0100 |
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