Re: Documentation Guide v2

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

 



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

-- 

fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
http://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux