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.
Attachment:
signature.asc
Description: This is a digitally signed message part
