Attempt to Assist in the generation of the FC5 Installation Guide

Paul W. Frields stickster at gmail.com
Tue Jan 3 19:16:26 UTC 2006


On Tue, 2006-01-03 at 10:44 -0800, Karsten Wade wrote:
> On Mon, 2006-01-02 at 13:50 -0500, Scott Glaser wrote:
> > Paul/Stuart,
> > 
> > I have started working on a rewrite of the installation guide 
> ...
> > Here is the Layout that I have come up with so far, 
> > http://fedoraproject.org/wiki/Docs/Drafts/InstallationGuide. 
> 
> My only suggestion so far is to avoid actually rewriting the content in
> the Wiki.
> 
> Conversion from Wiki to DocBook is not automated.  We can get valid XML,
> but merging the content is manual (at best).
> 
> Thanks for taking on this usability rewrite!

I had suggested this to Scott also in IRC.  I think the process might
work better (and be less exhausting for Scott!) if we use the Wiki page
as a place simply to outline and make terse notes.  Then Stuart and I
can do the actual "longhand" writing in CVS, and Scott can view the
results at the webtest host to monitor and critique our progress.  This
also keeps Scott from having to learn much about our style guidelines
and cuts down on our workload too, since it's easier (I think) for us to
write straight into CVS rather than convert -> merge (yuck) -> edit for
style.  Just my thoughts, waiting for others to comment...

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20060103/55b8a251/attachment.bin 


More information about the docs mailing list