[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Macro pre-processing?

From: Graham Percival
Subject: Re: Macro pre-processing?
Date: Sun, 9 Apr 2006 17:08:18 -0700

On 9-Apr-06, at 11:04 AM, Geoff Horton wrote:

I think the following messages to lilypond-users (as well as my own
complete inability to understand music functions) suggest that the
manual could use some work in this area.

A problem endemic to manuals, and one that I have no idea how to fix,
is that they're usually crystal-clear to someone who already knows the

And a problem endemic to the lilypond manual, and one that I have a few ideas how to fix, is that the person maintaining the docs doesn't understand a all the material.

In the case of scheme (chapter 11), I can honestly say that I do not fully understand a single section of the docs. But I'm swamped with other doc issues, so I never have time to sit down and really learn it. And if I don't understand the material, I certainly can't write docs about it. Rest assured that I've saved Nicholas' email, so some day when I've finished more pressing doc issues, I'll revisit this issue.

In a few days, I'll be making a big push to get more people involved in the docs. If you'd like to see the manual improved, please think about offering to do some of the jobs -- if other people do simple jobs, I can concentrate on learning (and then improving the docs) on simple things. If other people offer to do complicated jobs, I can work on simple things. If both areas are covered, I'm certain I can find other doc stuff to do.

- Graham

reply via email to

[Prev in Thread] Current Thread [Next in Thread]