Re: Why? -- "A Modest Proposal"

[<tomas@tuxteam.de>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Thu, Nov 17, 2016 at 10:52:41AM -0700, John L. Ries wrote:
> If we're drowing in documentation (and I always prefer to err on the
> side of too much data rather than too little), then it's in low quality,
> incomprehensible documentation, not the good stuff.

Careful! (see below)

>                                                      One of the
> weaknesses of open source is the difficulty outsiders have understanding
> that freely available code (programmers would much rather program than
> document their work, which is why making one's code self-documenting is
> always a plus).  Experimentation is good (if one has time), but easy to
> learn is better.

Now you have cast upon yourself the duty of finding *one* example of
"low quality, incomprehensible documentation", so we can together try
to fix it. Otherwise nobody will believe you ;-P

(Said, of course, with tongue-in-cheek. But, of course, if you accept
the challenge, I'll try to be up to the task and who knows, perhaps
we find other helping hands. Want to dance?)

regards
- -- tomás
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iEYEARECAAYFAlguIOUACgkQBcgs9XrR2kZL9wCdGSuA7GsybKETBf5WeIBEWWIg
42gAnRicx7dACBDTWOUi0ltq5AM+b+xp
=4Y7u
-----END PGP SIGNATURE-----