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