From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4213 invoked by alias); 24 Jan 2019 13:00:59 -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 3959 invoked by uid 89); 24 Jan 2019 13:00:49 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=BAYES_00,KAM_SHORT,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=sk:sourcew, homepage, webpages 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; Thu, 24 Jan 2019 13:00:43 +0000 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 520C154381; Thu, 24 Jan 2019 13:00:42 +0000 (UTC) Received: from [127.0.0.1] (ovpn04.gateway.prod.ext.ams2.redhat.com [10.39.146.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id BC98A67161; Thu, 24 Jan 2019 13:00:40 +0000 (UTC) Subject: Re: [PATCH] Replace contribution list in CONTRIBUTE file with wiki link To: Alan Hayward , Simon Marchi References: <20190123094558.58854-1-alan.hayward@arm.com> <79e6aeb8-fd9d-7269-ea6c-929812fd6f71@redhat.com> <46E9A635-C40D-4087-81BC-BA34DC55717F@arm.com> Cc: "gdb-patches@sourceware.org" , nd , Joel Brobecker From: Pedro Alves Message-ID: Date: Thu, 24 Jan 2019 13:00:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <46E9A635-C40D-4087-81BC-BA34DC55717F@arm.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-SW-Source: 2019-01/txt/msg00538.txt.bz2 On 01/23/2019 05:15 PM, Alan Hayward wrote: > Combing both threads. New version below > >> On 23 Jan 2019, at 16:03, Pedro Alves wrote: >> >> On 01/23/2019 09:46 AM, Alan Hayward wrote: >> >>> +https://sourceware.org/gdb/wiki/ContributionChecklist >> >> I'd rather point at https://sourceware.org/gdb/contribute/ >> and then have _that_ point at some page in the wiki. >> That's what I had suggested in the other thread. >> The reason is that the >> URL is going to be more stable than a wiki link, which we can >> rename, split, etc. a bit more freely. The contribution checklist page >> is quite large by now, and I've heard of people wishing for a smaller more >> concise entry point. The checklist was meant to be that, a checklist. >> A "how to contribute" page may have some higher level info to >> get people started. > Fair enough. Having the double link seemed redundant, but your > reasoning makes sense. > > The sourceware contribute page itself needs an update (it currently > points to the CONTRIBUTE file!) How do we go about making that change? > That has been the (mental) blocker for me thus far. The webpages are still in CVS somewhere. I never touched it myself. Joel, can you guide us here? AFAIK the current process is that commits go to both sourceware.org's CVS and to another copy in gnu.org as well for the https://www.gnu.org/software/gdb/ . I had chatted with Joel at the Cauldron about streamlining this, and the conclusion seemed to be that there's no real blocker for making the gnu.org version simply a redirect to sourceware.org. That would simplify things. The other neat step would be to migrate to git. :-) > Wanted to avoid rewriting as much as possible. But now I’m wondering if it > maybe needs reducing down a little more. > > How about the following (can repost with proper diff, but easier to read > if I just paste it) Yeah. It'd to be good to make sure to migrate any useful info being deleted, if not covered in the web site already, rather than just losing it, IMHO, though. I think most of the steps in the file are covered by the checklist wiki, but the larger/expanded intro text currently in gdb/CONTRIBUTE would be useful on the https://sourceware.org/gdb/contribute/ landing page, I believe. > > > > Contributing to GDB > > GDB is a collaborative project that relies on contributions. You can > help in this! You may wish to fix bugs, improve testing, port GDB to > a new platform, update documentation, add new features or optimizations, > contribute to the mailing lists or offical GDB website, etc. We welcome typo in "offical". > all of the above and feel free to ask on the GDB mailing lists if you are > looking for feedback or for people to review a work in progress. For > more information see: > > https://sourceware.org/gdb/ > > > In order for any code patches to be considered for submission, please > also see the contribution guide: I'm not very keen on this sentence since there's more to contribution that code patches: bug triaging, testing, helping users on the gdb mailing list, etc. > > https://sourceware.org/gdb/contribute/ > > Since this whole file is all about contributing, I think we can replace both URLs with a single URL pointing at the contribution page, and drop the "in order for any ..." sentence altogether. I.e., just say: ~~~ ... looking for feedback or for people to review a work in progress. For more information see: https://sourceware.org/gdb/contribute/ ~~~ Once there, it should be trivial and obvious for a user to reach the homepage. Thanks, Pedro Alves