Documentation Guide v2

[Paul W. Frields]

On Sun, 2005-04-24 at 17:16 -0500, Tommy Reynolds wrote:
> Uttered "Paul W. Frields" <stickster at 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
-------------- 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/20050424/e2c525ea/attachment.sig>