On Sun, 2005-04-24 at 17:16 -0500, Tommy Reynolds wrote:
Uttered "Paul W. Frields" <stickster(a)gmail.com>,
spake thus:
>
http://www.fedoraproject.org/wiki/DocsProject/DocumentationGuide
>
> You'll find notes for the new example tutorial up there as well.
I think C.5 should be "Authoring Your Document". That's less
imtimidating to potential authors since we will accept a new
document in _any_ format and help with transforming it into DocBook.
See, learning DocBook isn't a prerequisite -- it's the lingua franca
of the FDP but you can learn as you go. This part is a sales pitch.
Put the DocBook details down in III.F "DocBook Without Fear".
What'cha think? Do you want me to surgery the Wiki?
I came up with a better arrangement that also incorporates another piece
of Karsten's previous process work -- a document lifecycle plan. Keep
in mind the Guide is not just for the authors, but also for reference of
editors and such. But I agree completely that the "get involved"
section needed to have that part axed, and I did so. I put the DocBook
pitch down in the tools section where it belongs.
--
Paul W. Frields, RHCE
http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717