Re: Around again, and docs lead role

[Ricard Mira]

Neil Jerram wrote:
> Thanks Ricard; please see also my reply to Thamer.  What are your
> views so far about the existing docs?  (I'm finishing for
> a cold hard assessment here, not compliments.)

IMHO, the overall organization of the documentation isn't clear.  But
I know that documenting Guile is difficult, because there are many
different things to consider (C and Scheme, Scheme and translated
languages, applications and Guile, etc.).  I am thinking about these
issues.

Also, I believe that "Part V: Guile Modules" should disappear, because
features should be documented according to their functionality, not
according to their origin or implementation (SLIB, SRFIs, etc.).

-- 
Ricard Mira