From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 77264 invoked by alias); 21 Jan 2016 10:14:34 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 77253 invoked by uid 89); 21 Jan 2016 10:14:34 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.7 required=5.0 tests=AWL,BAYES_00,KAM_LAZY_DOMAIN_SECURITY,RCVD_IN_DNSWL_NONE autolearn=no version=3.3.2 spammy=week!, Hx-languages-length:2374, hide, Editing X-HELO: rock.gnat.com Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-SHA encrypted) ESMTPS; Thu, 21 Jan 2016 10:14:33 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 7DD171170B6; Thu, 21 Jan 2016 05:14:31 -0500 (EST) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id oKSSFgNmWEXn; Thu, 21 Jan 2016 05:14:31 -0500 (EST) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 21194117087; Thu, 21 Jan 2016 05:14:31 -0500 (EST) Received: by joel.gnat.com (Postfix, from userid 1000) id 137F345017; Thu, 21 Jan 2016 14:14:27 +0400 (RET) Date: Thu, 21 Jan 2016 10:14:00 -0000 From: Joel Brobecker To: Pedro Alves Cc: gdb-patches@sourceware.org Subject: Re: [RFC/RFA] gdb/CONTRIBUTE update (most of the info is now on our wiki) Message-ID: <20160121101427.GC5146@adacore.com> References: <1453019097-10519-1-git-send-email-brobecker@adacore.com> <569CD3B8.1010008@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <569CD3B8.1010008@redhat.com> User-Agent: Mutt/1.5.23 (2014-03-12) X-SW-Source: 2016-01/txt/msg00505.txt.bz2 Hi Pedro, > Thanks a bunch for doing this. It's been on my TODO for a long while > after this: > > https://sourceware.org/ml/gdb-patches/2014-10/msg00636.html > > IMO, we'd keep this file even more minimal, and instead of having > it point to the wiki page here, it'd point to: > > https://sourceware.org/gdb/contribute/ > > (which is also linked from the main page) > > and that page would be the one that would mention the wiki. > > My main reason would that the the "contribute" page in the web site > would be the canonical entry point, while the wiki page is a fast > moving target. E.g., it's growing past a checklist, so I wouldn't > be surprised if we end up splitting it into separate pages at some > point (and end up changing the URL). > > But TBC, I'm definitely already happy with what you propose. Sorry for the late reply - busy week! I just wanted to say that I tend to agree with your comments. I think we'll just need to iron the details out. One thing we might want to discuss: Editing the GDB web pages (html repository) is not hard per se, but is inconvenient: there are 2 CVS repositories to maintain in sync, with distinct ACLs for pushing. I personally have the procedure down pat, but I wouldn't recommend anyone else but one or two backups spend anytime getting setup. So, instead, I am wondering: Why not move the https://sourceware.org/gdb/contribute/ page to the Wiki? This page could still be the entry point, and be the more stable document; and then we could link to the checklist from there as you are suggesting. While discussion, I was trying to find ways to make the checklist a little more like a checklist (something you go through quickly and repetitively to make sure you haven't forgotten something each time). Because of all the comments and annotations, it's hard to go through it quickly, or not skip accidently a step. I agree everyone is in great shape if only one or two are skipped (;-)), but maybe there is a technical way we can only display the subject of each item on the checklist, and then have a toggle we can use to display/hide the explanations/rationale/examples... Not something to discuss right away necessarily, but perhaps something interesting. I'll get back to this when I can; maybe not this weekend, but the next one. -- Joel