On Monday 16 October 2006 23:11, Nick Rout wrote: > On Monday 16 October 2006 15:27, Derek Smithies wrote: > > Nick, > > There is another issue that you have not mentioned, that is quite > > relevant. > > > > Some coders say, "We wrote it as quickly as possible", or "did not want > > to clutter the source up with doxygen like comments", or "had trouble > > with the different documentation tools", or "the code is moving too > > quickly to write documentation", or some other excuse. > > At the end of the day, you end up with hundreds of thousands of lines of > > code, and no reasonable guide as to why things were done what &where. > > very true! this also applies to user docs, ie how to run the bloody thing - > which is a different but related problem to the source code documentation > that you speak of. As a linux-literate person, I wouldn't really read much > c/c++ source code, but I read a lot of README and man pages!
And what's the recipe to get tyro geeks to pay attention while they are in English Language classes at school? Or should the question be? - Why don't the schools teach English Language any more? -- CS
