On Tue, Dec 22, 2015 at 4:41 AM, Patrick Lauer <[email protected]> wrote: > Wiki says: > > "In this guide we are going to show you how to create a GLEP 63 > <https://wiki.gentoo.org/wiki/GLEP:63> based OpenPGP Key using > app-crypt/gkeys-gen > <https://packages.gentoo.org/packages/app-crypt/gkeys-gen> tool which is > the official way of managing OpenPGP keys in the Gentoo Infrastructure." > > So either the documentation is wrong, or we're supposed to use a broken > tool.
The GLEP is certainly official. I think the tool was intended to be, but the whole point of a "standard GLEP" is that you have to meet the standard, not use a particular implementation. gkeys isn't even the reference implementation. > > Or just point people at a random email, because that's about as good as > documentation. Thank you for writing up a guide/outline. You appear to hate mediawiki, but you do realize that you could probably copy/paste that email into the box and call it half-done, right? Somebody else can always come along and improve it, and that is kind of the whole point of a wiki, and of FOSS in general. > > Please, stop wasting people's time, if you write code or documentation > write it once properly, don't release untested things and claim they are > an official tool, and don't ignore complaints (because they mean, as a > first approximation, that you screwed up and need to fix stuff) > Gentoo devs and volunteers are more than welcome to ignore complaints. I'll take half-implemented code over no code any day of the week. Maybe somebody isn't good at writing documentation, and we benefit from getting their contributions all the same which somebody can later follow-up on (perhaps somebody who is better at writing documentation than code). You're going to make more progress with evolutionary steps. BTW, bugs aren't complaints, and I don't really consider "complaints" nearly as useful. If you want to point out an error by all means do so. You can do it without implying that somebody somehow owed you something better. They don't. -- Rich
