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/