On Tue, 2004-09-28 at 19:44, Kevin H. Hobbs wrote: > 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. > > ______________________________________________________________________ Kevin, Thanks for writing this. It is a much needed tutorial. I moved the open bug to block the docs in progress tracker instead. I co-authored an article in the first issue of Wide Open Magazine about the 2.6 kernel, including how to recompile it. I'll compare your version with mine and see if I can add to it. Please send me your latest version if you have made any changes since the version you posted and I can send you a patch. Or, if you prefer I can just list the changes in an email. Let me know which you prefer. Cheers, Tammy Tammy
