Re: RFD: Essential packages, /, and /usr
[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 debian-policy-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: