-----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-----
