Nicholas Clark <firstname.lastname@example.org> writes: > >There seems to be a consensus on perl5-porters that ever more documentation >is good. > >Bollocks. > >LESS documentation is good. If you can say the same things with less words, >this is much better. The danger we have in increasing the amount of >documentation is given constant programmer time, they read less and less >of it, and are more and more likely to miss the important bits. Also given finite maintainer time, the more docs there are the more likely they are to "rot" and not track the code changes. I hold up the many places where aspects of 'open' are now documented as an example. What the commercial books get, that pods do not, is an editor.