what next?

[Karsten Wade]

On Thu, 2006-11-09 at 17:02 +0000, Dimitris Glezos wrote:

> I believe we can do that. We just have to start designing and agreeing 
> on a good hierarchy for our handbook and build on top of that. Oh, and 
> of course, decide what our audience will be. :)

s/audience/audiences/ :)

Let's start with where the most pain is, people who are new to Fedora
and/or Linux.  Make sense?

Our plan should be able to handle content addressed at all levels, but
this "Experienced computer user who knows what they want to do but who
is knew to Fedora" is a good place to start.

In parallel, we can work on content that is good for experienced users
who want more formal content that tells how to do more advanced stuff,
like the Administration Guide.  Just given a choice of resources ...
well, admins can adapt content from other distros better than newbies
can. :)

> One definite goal of our should be to *converge* the places/ways we 
> maintain content and minimize the same-content-different-location 
> issues. Try to move as much informally-written content as possible from 
> the wiki to the guides/handbook.

+1, except I'd like to see a way, as we are discussing, where the Wiki
is an editor choice.  All content in XML but your choice of editors.
Wow.

> The difficult part would be to strike a good balance for this. Ie, we 
> want to minimize duplicate content but at the same time we want the 
> Release notes to contain installation notes that should exist in the 
> Installation Guide. Modularization implies maintainability but also 
> dependencies and we will have to make some choices for the places where 
> we will duplicate content instead of referencing.

We may need to move beyond to DITA to do this, and for us to be
successful at that, we need to make success with what we have so far.
Yes?

> If everyone is OK with the idea, I'll try to bootstrap a tree structure 
> based on other guides (like the excellent FreeBSD cookbook) and put it 
> on the wiki for further discussion. Thankfully, most of the big parts 
> are already there (IG, DUG, FAQ).

If you didn't see this, this is the page that I threw up recently from
the initial handbook discussion earlier this/last week:

http://fedoraproject.org/wiki/DocsProject/Handbook

Just a place to start from. :)

- 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/20061109/ac4568a3/attachment.sig>