kernel-compilation-tutorial

[Kevin H. Hobbs]

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.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20040928/88442f69/attachment.bin