Re: documentation suggestion

[Carl D. Sorensen]

On 11/11/08 12:56 PM, "Graham Percival" <address@hidden> wrote:

> On Mon, Nov 10, 2008 at 07:12:50AM +0000, John Williams wrote:
>> Graham Percival <graham <at> percival-music.ca> writes:
>>
>>> On Mon, Nov 10, 2008 at 02:50:06AM +0000, John Williams wrote:
>>>> I think it would be extremely helpful for people attempting to tweak
>>>> ilypond
>>>> if there were examples in the documentation whenever a tweak is mentioned.
>>>
>>> That was decided over a year ago.  It takes hundreds of hours of
>>> manpower to update the complete docs.
>>
>>> Unfortunately you missed the golden opportunity to be trained on
>>> this, since the Grand Documentation Project ended a few months
>>> ago.
>>
>> I'm a little confused.  Are the examples not there because it was decided in
>> favor but there hasn't been time to add them to the docs yet, or are they not
>> there because it was decided against and the docs project is over?
>
> The docs don't match our desired standards because we only had
> approximately 1000 hours of help for the doc project; I estimate
> that another 500 hours are needed.
>
> If you are interested in contributing towards those remaining 500
> hours, you'll need to learn how to use git, make patches, possibly
> compile the docs yourself, and the relevant doc policies.  During
> GDP, I took care of those details so that contributors could get
> started much quicker.

Trevor and I are willing to manage doc contributions for those who don't
want to get up to speed on those details.

John, if you want to contribute to the documentation, we can get you the
relevant policies and you can join the doc team.

Thanks,

Carl