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 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
