[ben] > [snipped a bunch of irrelevant crap in order to focus on the obviously > ridiculous]
[Anthony] > Documentation can often be a nuisance: if there's too much of it or > if it's badly written so it's hard to find anything, or if it doesn't > match reality, or if the burden of maintaining the documentation stops > you from doing things that would be productive. > > Things are very rarely as simple as "four legs good, two legs bad". I beg to differ. Why do you think people are afraid of comments? (cf. Linux coding standards, for example) Because comments and code *do* get out of sync. And then they are *worse* then not existing, because they lead the bug fixer astray with irrelevant details. Anthony certainly has a valid point: if we do make a list, and the list gets out of sync with the distribution, then suddenly, people will wonder "hmm....how can this init script work at all?" That would be a problem. I am not at all sure the problem is as dire as Anthony makes it out to be, but dismissing his arguments as "ridiculous" is silly. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
