On Thu, 2004-09-30 at 11:10 -0400, Tammy Fox wrote: > 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  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  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! > > > > > > > > >  http://fedora.redhat.com/participate/documentation-quick-start/ > > >  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 Sorry, I got behind on my e-mail. Paul Frields gave me some pointers, but I would appreciate any input available. I started this because all I could find was the flamewar.
Description: This is a digitally signed message part