I have worked for a few software-producing companies, and the linux code
is a lot worse. It is not very helpful to find examples either way. I
think most people agree a more documented kernel would allow more people
to contribute. The problem is that documenting is the most boring part of
writing software, and most people work on linux for fun.
The most likely scenario I can think of that actually involves the
documentation being writtn is that someone with the overview of the kernel
makes a description of the basic interdependencies and fundamental ideas.
Then other people can fill in the details. This would hopefully not place
to great a burden on the developers.
And no, I don't have the knowledge of the linux kernel needet to do this,
my head is compleatly filled with another kernel att the moment. :(
Peter