I read the README for the 2.6.X kernel, and have an idea about how to make it better so that it could be a little bit easier to understand. As it now is, it can be a bit confusing for people who are new to Linux and who are new to building the kernel. Since the README does not seem to change that much between the versions, if it is updated once then it can be helpful for lots of newbies like me.
1) Put the items into clearly marked sections. Three sections at least. One section would be for downloading the kernel, one for building the kernel, and one for patching the kernel. Right now, there are no clear section divisions in the README and it is confusing to know what part is for the patch and what part is for the entire build.
2) Show the commands to use separately for each step. Have a brief section description to clearly separate the steps. When a command is issued, show what directory that command should be used in, and the full path name in your example.
3) Add some comments of things that newbies would not know about, but an experienced user would know about, such as the options for the commands that work for most cases.
4) Add some information about the locations of where files are stored from the make commands, and how it selects the arch directory. For example, if you select a configuration option to use a different processor than i386, such as a pentium 4, is it going to put the image in another directory?
5) Explain about why you need to copy the kernel image into the boot directory. The make install seems to already do that, but it changes the name to something other than bzImage, such as linux-2.4.0
|