[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) |
Hi!
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. ;-)
Thanks,
Ludo’.
- [PATCH] Turn on more documentation, Noah Lavine, 2012/05/02
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/03
- Re: [PATCH] Turn on more documentation, Ludovic Courtès, 2012/05/06
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/07
- Re: [PATCH] Turn on more documentation,
Ludovic Courtès <=
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/12
- Re: [PATCH] Turn on more documentation, Ludovic Courtès, 2012/05/14
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/14
- Re: [PATCH] Turn on more documentation, Ludovic Courtès, 2012/05/14
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/14
- Re: [PATCH] Turn on more documentation, Andy Wingo, 2012/05/15
- Re: [PATCH] Turn on more documentation, Ludovic Courtès, 2012/05/15
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/15
- Re: [PATCH] Turn on more documentation, dsmich, 2012/05/14
Re: [PATCH] Turn on more documentation, Andy Wingo, 2012/05/15