Hacker News new | ask | show | jobs
by nickysielicki 3234 days ago
Now any reference to /usr/bin/gpg2 is broken. Every wiki that told people they had to specify gpg2 to use XYZ feature is lying. Every script and environment variable that depends on /usr/bin/gpg2 existing is now broken, depending on if your packager decides to --enable-gpg-is-gpg2.

Do a search for '"gpg2" inurl:wiki' to see a bunch of now-broken documentation.

1 comments

This is something I really dislike about the use of 3rd-party wikis for documenting software.

They always seem like a good idea at first, but then they slowly become misleading as contributors move on. You can't even call them "irrelevant" at that point because readers don't know they've become irrelevant.

And, by spending energy on the wiki, people don't try improving the upstream documentation. I assume they were motivated to make the wiki due to some problem with the upstream doc but, in the end, the upstream docs don't get improved, and you have a confusing wiki.

Please work with the upstream project on documentation instead. And if you are the upstream, consider a policy of rejecting patches that don't amend the docs appropriately.