[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] Turn on more documentation
From: |
dsmich |
Subject: |
Re: [PATCH] Turn on more documentation |
Date: |
Mon, 14 May 2012 17:26:31 -0400 |
---- Noah Lavine <address@hidden> wrote:
> Hello,
>
> > From “Organisation of this Manual”:
> >
> > *Chapter 6: Guile API Reference*
> > This part of the manual documents the Guile API in
> > functionality-based groups with the Scheme and C interfaces
> > presented side by side.
> >
> > *Chapter 7: Guile Modules*
> > Describes some important modules, distributed as part of the Guile
> > distribution, that extend the functionality provided by the Guile
> > Scheme core.
> >
> > So I think the idea is for core functionality to be in Chapter 6, and
> > “peripheral things” to be in Chapter 7. The modules you mention would
> > fall in the second category, I think.
>
> That's certainly enough for this project, but I think in general this
> distinction is not very clear. How would someone guess what
> functionality is considered "core" and what functionality is an
> extension? My first guess would be that things in the (guile) module
> are core and everything else is an extension, but that is not the
> case. Does this come from an earlier time when the Guile core was
> distributed separately from the Guile libraries?
>
> 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 have always had a very difficult time trying to locate the documentation for
a module by drilling down through the info menus. I always seem to go to the
wrong section. I have much better results starting from an index.
-Dale
- Re: [PATCH] Turn on more documentation, (continued)
- Re: [PATCH] Turn on more documentation, Noah Lavine, 2012/05/07
- Re: [PATCH] Turn on more documentation, Ludovic Courtès, 2012/05/07
- 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 <=
Re: [PATCH] Turn on more documentation, Andy Wingo, 2012/05/15