From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id BA1AE1384B4 for ; Tue, 22 Dec 2015 12:08:51 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id E3FC721C04B; Tue, 22 Dec 2015 12:08:45 +0000 (UTC) Received: from mail-ig0-f171.google.com (mail-ig0-f171.google.com [209.85.213.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id AC16421C042 for ; Tue, 22 Dec 2015 12:08:44 +0000 (UTC) Received: by mail-ig0-f171.google.com with SMTP id to4so58438189igc.0 for ; Tue, 22 Dec 2015 04:08:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:content-type; bh=pksu2wVrykrnnr6DNBH6zpG8Bf08fulAkw3u12eS44o=; b=zxr5Q7WQql5NDKdoBGV9funvZRIoEyyFGe8j2/eVgSaxneikvFo//lXxiwyZ8Ggl6i 1s7JFPkC2pWk6tT/zBSJpQc8GGYZ07qE+jZfeH7pS/SzgHCVDBnELBJltXbE4ys3sFsm XoKfMWDBrVj+lnjy2o38/V/oVHx4ccAHw4SXGovg29AfnMfGfH33DhHeHQXNLKpfe9Jh gbw8a8gzR2sFc8zNVDZHAiNC0Et6xIspu6D3xUoPfpD1M6N8O5CJd8gzQklx1O4qcy7O PeDRryyyMNE52OXw5Tf/3jR8zZcqbw1UxuCIWvFRDXC0vJSyYy79BbXWJoZ9Ry6ifZBF BrZw== Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 X-Received: by 10.50.73.40 with SMTP id i8mr23032983igv.70.1450786124022; Tue, 22 Dec 2015 04:08:44 -0800 (PST) Sender: freemanrich@gmail.com Received: by 10.79.38.210 with HTTP; Tue, 22 Dec 2015 04:08:43 -0800 (PST) In-Reply-To: <56791ACB.3000903@gentoo.org> References: <566DACB3.2010105@gentoo.org> <20151213222001.0c1c466a3f3b8b0b53c69a9d@gentoo.org> <20151213190045.1e186781.dolsen@gentoo.org> <20151220212127.6e5cd419@caribou.gateway.pace.com> <56791ACB.3000903@gentoo.org> Date: Tue, 22 Dec 2015 07:08:43 -0500 X-Google-Sender-Auth: j4HKe5tIwrrlYS3ujZLTdle2eUg Message-ID: Subject: Re: [gentoo-dev] Re: repo/gentoo.git, or how committing is challenging From: Rich Freeman To: gentoo-dev Content-Type: text/plain; charset=UTF-8 X-Archives-Salt: cc36346e-e0d8-4c89-bba4-7b37376f2ee8 X-Archives-Hash: 515af685091d20f6b58859c30a989842 On Tue, Dec 22, 2015 at 4:41 AM, Patrick Lauer wrote: > Wiki says: > > "In this guide we are going to show you how to create a GLEP 63 > based OpenPGP Key using > 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