[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Documentation Guide v2



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

Attachment: signature.asc
Description: This is a digitally signed message part


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]