On Tue, 2004-09-28 at 17:46 -0400, Paul W. Frields wrote:
On Tue, 2004-09-28 at 14:19, Kevin H. Hobbs wrote:
> I just hacked together what I understand form the flamewars. I am about
> to try to follow my own instructions now and see if I'm even close. :-)
>
> Coments are absolutely welcome. I really have no idea what I'm doing.
Your work is welcome. A couple hints on how to proceed:
1. Check out the Quick Start Guide [1] for an easy to read intro to how
things [are supposed to] work with FDP. Especially important is the
section on what you as a writer should be doing other than just working
through the ideas.
Ya I read it, sigh. I was going to just make a text file but nooOOoo I
get to learn how to make it all pretty.
2. You might want to learn enough Emacs to make your DocBook XML
editing
easier. I never knew more vi than I needed to get by, but learning the
same amount of Emacs wasn't any more difficult. The Docs Guide [2] has a
chapter on using psgml, but there's also nXML and psgmlx out there too.
gvim seems to be doing an ok job. It likes REALLY big indents but
whatever. I'll give emacs another go though.
3. You should include a better Introduction in your tutorial. Doing
this
helps you get an idea of what you want to accomplish in the tutorial,
and also what you *don't* want to accomplish. That helps keep you on
point and prevents your document from spinning off-topic.
I'll definitely want to flesh it out more for sure. I don't quite know
enough to get too off topic. And the more people try to tell me to
include stu
If you want an
example, I will humbly offer my mirror-tutorial as an example. My
current build is viewable at
http://docs.frields.org -- you will find
other docs there that are not good examples, but the mirror-tutorial
follows guidelines we hashed out on the list previously.
Thanks for participating!
[1]
http://fedora.redhat.com/participate/documentation-quick-start/
[2]
http://fedora.redhat.com/participate/documentation-guide/
--
Paul W. Frields, RHCE
I'll check those out for sure.