guile-devel
[Top][All Lists]
Advanced

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

Re: [PATCH] Turn on more documentation


From: Noah Lavine
Subject: Re: [PATCH] Turn on more documentation
Date: Mon, 14 May 2012 11:14:23 -0400

Hello,

>> Unless there is going to be some other distinction between core and
>> extensions, it would seem more natural to me to document everything by
>> functionality, in the same part of the manual. Some sections would
>> correspond to modules, because modules are also supposed to group
>> things by functionality, but that would not be the rule for how the
>> manual worked. What do you think?
>
> I tend to agree, but then I’m not sure what a better sectioning would be
> in practice.  Any ideas?

I think of our current situation as having three top-level lists of
functionality, in API Reference, Guile Modules, and Standard Library.
How about just merging them into one list?

> Perhaps this could be worked out in ‘master’, so that node names don’t
> change for 2.0.x.

Yes, I certainly agree that we shouldn't change this for 2.0.

Thanks,
Noah



reply via email to

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