[Top][All Lists]

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

Re: [PATCH] Turn on more documentation

From: Ludovic Courtès
Subject: Re: [PATCH] Turn on more documentation
Date: Mon, 07 May 2012 16:31:23 +0200
User-agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.93 (gnu/linux)


Noah Lavine <address@hidden> skribis:

> Hello,
>> The problem is that the auto-generated “Standard Library” section looks
>> very poor in comparison to the rest of the manual.  So we should really
>> try hard to write good doc by hands for these, and come up with a handy
>> structure (instead of one node per module, all under “Standard
>> Library”).
> I could do that pretty easily, but I'm afraid that documentation that
> isn't in the same file as the code would tend to be updated less often
> than documentation in the same file.

All of our manual except “Standard Library” is maintained this way.  It
takes discipline to keep up-to-date, but it also leads to a better
manual IMO.

>> However, I believe Thien-Thi’s Guile 1.4 has good doc for at least some
>> of these modules, and it would be great if it could be incorporated.
>> WDYT?
> That would be ideal, but I was concerned that the documentation wasn't
> copyrighted by the FSF. Unless Thien-Thi is interested in contributing
> it, of course.

Yes, I was hoping he would be reading us, let’s see.  ;-)


reply via email to

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