Re: [PATCH] Replace contribution list in CONTRIBUTE file with wiki link

[Alan Hayward <Alan.Hayward@arm.com>]

Combing both threads. New version below

> On 23 Jan 2019, at 16:03, Pedro Alves <palves@redhat.com> 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 <https://sourceware.org/gdb/contribute/>
> 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.
> 
> Thanks,
> Pedro Alves

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?



> On 23 Jan 2019, at 15:21, Simon Marchi <simon.marchi@ericsson.com> wrote:
> 
> On 2019-01-23 4:46 a.m., Alan Hayward wrote:
>> 
>> You may also want to submit your change so that can be considered for
>> -conclusion in a future version of GDB (see below).  Regardless, we
>> -encourage you to distribute the change yourself.
>> +conclusion in a future version of GDB.  For a full guide on how to
>> +submit patches see:
> 
> Is it just me, or the "You may also..." sentence is very weird? conclusion
> or inclusion?  There seems to be a missing work after "so that".
> 
> Otherwise, this LGTM, thanks.
> 
> Simon

Agreed. I missed that.



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)



			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
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:

https://sourceware.org/gdb/contribute/