small makes big
Karsten Wade
kwade at redhat.com
Sun Oct 8 21:54:01 UTC 2006
Just a note to be clear, since at least Dimitris had some questions
about the intent here.
<glezos> quaid, what I wanted to say (after re-reading the discussions)
is that, indeed it might be difficult to handle a huge file. But, it
might not be really difficult to coordinate the docs (cross-links, no
duplicated content) so that at a point they might get bundled together.
<glezos> What I didn't understand is whether you would be interested in
such an approach.. Small, indivitual docs that complement each other and
that could make one whole, self-contained at some point.
That is exactly what we want here. Small, individual documents that
are:
* Written in a consistent style;
* Follow standard conventions;
* Have complementary topics;
* Stand alone, yet
* Fit into a whole
One outcome of this should be a Fedora (Beginners) Handbook, a
comprehensive guide to all things for new to Linux/new to Fedora users.
A big challenge here is having a document self-identify with a certain
experience level of user, and then *keep all material within that
level*.
For example, if we decide beginners really need minimal CLI interaction,
then anything that is written to fit into a beginners handbook needs to
follow that convention.
Before we begin a break-out group to discuss and decide on all this
separately, lets explore this on-list a little longer.
- Karsten
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20061008/369a3f28/attachment.sig>
More information about the fedora-docs-list
mailing list