[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
Re: PR/47769 CVS commit: pkgsrc/textproc/ispell-ro
The following reply was made to PR pkg/47769; it has been noted by GNATS.
From: David Holland <dholland-pbugs%netbsd.org@localhost>
Subject: Re: PR/47769 CVS commit: pkgsrc/textproc/ispell-ro
Date: Thu, 2 May 2013 09:23:09 +0000
On Wed, May 01, 2013 at 10:10:07AM +0000, Timothy Lee Roden wrote:
> > Relying solely on documents is not going to help anyone, since
> > documents can be out of date, or not cover cases, or be wrong, or open
> > to misinterpretation, or incomplete, or not mention parts that are
> > needed to gain context, or lose something in translation.
> This is one thing that I would like to see changed during my time
> here. It is one of my biggest criticisms of pkgsrc from a
> developer's perspective. We can fix all of those issues, as they
> are not difficult to fix. Tedious, perhaps, but not
> irreconcilable. I have a short list of items to document in pkgsrc
> that fall into one or more of those categories. DIST_SUBDIR
> unknowingly was one of them, apparently.
Sure, by all means fix the documentation. It's just that it's rarely
sufficient to use only documentation to get going on any project.
Also remember that those of us who have been around a while and
already know how things work don't necessarily notice problems with
the documentation. Overtly wrong statements, probably we'll notice, if
we happen to look at them. Missing stuff, much less so. Ambiguous
statements, very rarely.
Every time someone comes on board it's an opportunity to improve the
documentation. These opportunities should not be wasted.
However, it's usually more efficient to discover them before
committing rather than after. :-/
David A. Holland
Main Index |
Thread Index |