Re: [PATCH] Quick-start guide

[ludo@gnu.org (Ludovic Courtès)]

Hi,

yoosty@gmail.com skribis:

> After reading the feedback here and spending some more time in IRC (which
> really drives home the feedback about translations and colloquialisms,
> thanks John) I would like to do the following:
> - Add a contiguous set of examples to the existing "System Installation"
> section (such that if you follow the examples you will almost certainly end
> up with a working system, even if you don't read much of anything else)

You mean OS config examples?  Currently there are 3 example
configurations.  We could add more, but I wonder if that wouldn’t be too
much for the manual itself (we could still add more to the installation
image, though.)

> - Add at least one more sub-section to "System Installation" that
> introduces users to extending/customizing the initial system's .scm file
> -- Something like a "Where to go from here? Customizing your installation."
> -- A chance to tease users in to Scheme programming

Makes sense.  The “Using the Configuration System” section was intended
to achieve this, but maybe it’s failing.  Do you think it could be
improved, or is a new section needed, and if so, how should we
articulate both?

Thanks,
Ludo’.