From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1302 invoked by alias); 4 Oct 2016 17:18:42 -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 1285 invoked by uid 89); 4 Oct 2016 17:18:42 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-4.5 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=Hx-languages-length:2995, surprised, department, website X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 04 Oct 2016 17:18:31 +0000 Received: from int-mx14.intmail.prod.int.phx2.redhat.com (int-mx14.intmail.prod.int.phx2.redhat.com [10.5.11.27]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id D51A84C466; Tue, 4 Oct 2016 17:18:30 +0000 (UTC) Received: from [127.0.0.1] (ovpn01.gateway.prod.ext.ams2.redhat.com [10.39.146.11]) by int-mx14.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id u94HIT2X020628; Tue, 4 Oct 2016 13:18:30 -0400 Subject: Re: [RFC/RFA] gdb/CONTRIBUTE update (most of the info is now on our wiki) To: Joel Brobecker References: <1453019097-10519-1-git-send-email-brobecker@adacore.com> <569CD3B8.1010008@redhat.com> <20160121101427.GC5146@adacore.com> Cc: gdb-patches@sourceware.org From: Pedro Alves Message-ID: Date: Tue, 04 Oct 2016 17:18:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0 MIME-Version: 1.0 In-Reply-To: <20160121101427.GC5146@adacore.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-SW-Source: 2016-10/txt/msg00050.txt.bz2 Hi Joel, >From the better-late-than-never department... On 01/21/2016 10:14 AM, Joel Brobecker wrote: > 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? If only we'd move the website to git... :-) > > 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. *nod* > > 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. > At this point, I'm convinced that the file in the sources serves no real use, and I'd just remove it entirely. But, in any case, I think the next best step would be to tweak to point at some gdb/wiki/contribute page, as discussed above, instead of pointing at gdb/CONTRIBUTE in the sources. That seems to be the main blocker. Thanks, Pedro Alves