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 _______________________________________________ lilypond-user mailing list lilypond-user@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-user
