Re: PR/47769 CVS commit: pkgsrc/textproc/ispell-ro

[David Holland <dholland-pbugs%netbsd.org@localhost>]

The following reply was made to PR pkg/47769; it has been noted by GNATS.

From: David Holland <dholland-pbugs%netbsd.org@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: 
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
 dholland%netbsd.org@localhost