[Top][All Lists]

[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: Tue, 15 May 2012 20:19:59 -0400


On Tue, May 15, 2012 at 5:25 PM, Ludovic Courtès <address@hidden> wrote:
> Hi,
> Andy Wingo <address@hidden> skribis:
>> What if we merge "Guile Modules" and "Standard Library" into one
>> "Standard Library" node, and keep "API Reference" as it is?
> Sounds good to me.  Perhaps “Standard Library” could have sub-sections,
> like “Data Structures”, “Web”, “XML”, “Texinfo”, etc.

Yes, that sounds good to me too. However,

On Tue, May 15, 2012 at 4:24 PM, Andy Wingo <address@hidden> wrote:
> For me the difference is that nodes of "API reference" describe
> functionality that is often not segregated in modules, whereas "Guile
> Modules" has nodes that describe modules.

this distinction makes sense to me, but is not actually what is in
place. For example, "LALR parsing", "Line Oriented and Delimited
Text", "Block reading and writing", and "Local evaluation". How about
having "API Reference" be the core module, and "Guile Modules" have
everything else?

I'm still not sure that's the right distinction though.


reply via email to

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