Re: Contributor covenant

[Alex Sassmannshausen <alex.sassmannshausen@gmail.com>]

Hello,

Ricardo Wurmus writes:

> Ludovic Courtès <ludo@gnu.org> writes:
>
> [...]
>
>> In commit e15fcdd, I added a ‘CODE-OF-CONDUCT’ file taken from
>> <http://contributor-covenant.org/>, which is essentially a way of
>> telling the lurkers out there: yes, we do our best to be welcoming and
>> we’re committed to doing so, so join us!  The guix-maintainers@gnu.org
>> address it mentions is currently an alias for ludo@gnu.org (though I’d
>> like it to become more than just me!).
>
> Thank your for this!
>
> The code of conduct itself sounds good; but the sentence in the manual
> is a little hard to read and a little meandering, in my opinion.
>
>> +In the interest of welcoming everyone who thinks this is a great project
>> +to contribute to---which it is, indeed!---contributors express their
>> +commitment to providing a warm, friendly, and harassment-free experience
>> +by agreeing to our ``Contributor Covenant'', adapted from
>> +@url{http://contributor-covenant.org/}, and which can be found in the
>> +@file{CODE-OF-CONDUCT} file in the source tree.
>> +
>
> I find it hard to suggest better wording, but I think there’s a lot in
> this sentence and it might be better to split it up or simplify it a
> little.  Maybe splitting it into two sentences would be clearer?  E.g.:
>
>> We welcome everyone to contribute to this project.  To maintain(?) a
>> warm, friendly, and harassment-free experience, contributers agree to
>> our ``Contributor Covenant'' (adapted from
>> @url{http://contributor-covenant.org/}), which can be found in the
>> @file{CODE-OF-CONDUCT} file in the source tree.
>
> Admittedly it doesn’t have the charms of the original version, but I
> find the latter somewhat clearer.  What do you think?
>
> ~~ Ricardo

In an attempt to be helpful, here a further suggestion; take it or leave
it as you see fit (happy to patchify it).

>> We want to provide a warm, friendly and harassment-free environment,
>> so that anyone can contribute to the best of their abilities.  To
>> this end our project uses a ``Contributor Covenant'', which was
>> adopted from @url{http://contributor-covenant.org/}.  You can find a
>> local version version in the @file{CODE-OF-CONDUCT} file in the
>> source tree.

HTH,

Alex