[PATCH] doc: Add a reference to a page explaining consensus decision making.

  • Done
  • quality assurance status badge
Details
3 participants
  • Ludovic Courtès
  • Maxim Cournoyer
  • pelzflorian (Florian Pelz)
Owner
unassigned
Submitted by
Maxim Cournoyer
Severity
normal
M
M
Maxim Cournoyer wrote on 17 Mar 2023 21:22
(address . guix-patches@gnu.org)(name . Maxim Cournoyer)(address . maxim.cournoyer@gmail.com)
20230317202234.25156-1-maxim.cournoyer@gmail.com
This is to make explicit something which until now had always been implicit.

* doc/contributing.texi (Commit Access): Mention that committers are expected
to employ consensus decision making.
---
doc/contributing.texi | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)

Toggle diff (21 lines)
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 911c3a7bbf..4db0fdc76e 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1728,7 +1728,11 @@ project for at least 6 months. This ensures enough interactions with
the contributor, which is essential for mentoring and assessing whether
they are ready to become a committer. Commit access should not be
thought of as a ``badge of honor'' but rather as a responsibility a
-contributor is willing to take to help the project.
+contributor is willing to take to help the project. It is expected from
+all contributors, and even more so from committers, to collaborate in a
+consensus decision making fashion. To learn what consensus decision
+making means and understand its finer details, you are encouraged to
+read @url{https://www.seedsforchange.org.uk/consensus}.
The following sections explain how to get commit access, how to be ready
to push commits, and the policies and community expectations for commits

base-commit: 933051281fbed0ae71bd40c24a701faf2a02791c
--
2.39.1
L
L
Ludovic Courtès wrote on 26 Mar 2023 23:35
(name . Maxim Cournoyer)(address . maxim.cournoyer@gmail.com)(address . 62246@debbugs.gnu.org)
87wn339ox2.fsf@gnu.org
Hi Maxim,

Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:

Toggle quote (5 lines)
> This is to make explicit something which until now had always been implicit.
>
> * doc/contributing.texi (Commit Access): Mention that committers are expected
> to employ consensus decision making.

[...]

Toggle quote (5 lines)
> -contributor is willing to take to help the project.
> +contributor is willing to take to help the project. It is expected from
> +all contributors, and even more so from committers, to collaborate in a
> +consensus decision making fashion. To learn what consensus decision

The first sentence was hard to parse at first. Perhaps a slight
improvement: “… from committers, to help build consensus and make
decisions based on consensus.”

Otherwise LGTM; thanks for working on it!

Ludo’.
M
M
Maxim Cournoyer wrote on 28 Mar 2023 17:15
(name . Ludovic Courtès)(address . ludo@gnu.org)
87edp8oqje.fsf_-_@gmail.com
Hi,

Ludovic Courtès <ludo@gnu.org> writes:

Toggle quote (22 lines)
> Hi Maxim,
>
> Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:
>
>> This is to make explicit something which until now had always been implicit.
>>
>> * doc/contributing.texi (Commit Access): Mention that committers are expected
>> to employ consensus decision making.
>
> [...]
>
>> -contributor is willing to take to help the project.
>> +contributor is willing to take to help the project. It is expected from
>> +all contributors, and even more so from committers, to collaborate in a
>> +consensus decision making fashion. To learn what consensus decision
>
> The first sentence was hard to parse at first. Perhaps a slight
> improvement: “… from committers, to help build consensus and make
> decisions based on consensus.”
>
> Otherwise LGTM; thanks for working on it!

I've applied your suggestion to my local branch, thanks. I'm CC'ing
guix-devel and guix-maintainers to make sure everybody is informed of
this proposed change.

It's still time to voice any concern you may have with this suggested
change. I'll leave it open for a few more days.

--
Thanks,
Maxim
M
M
Maxim Cournoyer wrote on 3 Apr 2023 22:02
(name . Ludovic Courtès)(address . ludo@gnu.org)
87ttxwd9a4.fsf_-_@gmail.com
Hi,

Maxim Cournoyer <maxim.cournoyer@gmail.com> writes:

Toggle quote (33 lines)
> Hi,
>
> Ludovic Courtès <ludo@gnu.org> writes:
>
>> Hi Maxim,
>>
>> Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:
>>
>>> This is to make explicit something which until now had always been implicit.
>>>
>>> * doc/contributing.texi (Commit Access): Mention that committers are expected
>>> to employ consensus decision making.
>>
>> [...]
>>
>>> -contributor is willing to take to help the project.
>>> +contributor is willing to take to help the project. It is expected from
>>> +all contributors, and even more so from committers, to collaborate in a
>>> +consensus decision making fashion. To learn what consensus decision
>>
>> The first sentence was hard to parse at first. Perhaps a slight
>> improvement: “… from committers, to help build consensus and make
>> decisions based on consensus.”
>>
>> Otherwise LGTM; thanks for working on it!
>
> I've applied your suggestion to my local branch, thanks. I'm CC'ing
> guix-devel and guix-maintainers to make sure everybody is informed of
> this proposed change.
>
> It's still time to voice any concern you may have with this suggested
> change. I'll leave it open for a few more days.

The change is now installed.

--
Thanks,
Maxim
Closed
P
P
pelzflorian (Florian Pelz) wrote on 9 Apr 2023 19:39
(address . 62246@debbugs.gnu.org)(address . maxim.cournoyer@gmail.com)
87cz4d7y6b.fsf@pelzflorian.de
Hi Maxim and all.

Maxim added to doc/contributing.texi:
Toggle quote (6 lines)
> It is expected from all contributors, and even more so from
> committers, to collaborate in a consensus decision making
> fashion. To learn what consensus decision making means and
> understand its finer details, you are encouraged to read
> @url{https://www.seedsforchange.org.uk/consensus}.

Only now, that it is already pushed, have I taken the time to read
(or, at some point, skim) the link.

I just want to acclaim:

* I agree with the addition of this kind of writing.

* Seeds for Change is more politically left than I first expected, and
the consensus sub-page uses not only examples that chime well with
free software and Outreachy, but also one-sided views on issues like
housing. Perhaps such examples will prompt dissent in the future.

It would have been an option (a worse option) to add consensus
decision making to the manual without linking to such an extensive
text.

Nonetheless, the way it is written, the manual asks for agreement
with consensus decision making, not with Seeds for Change or the
examples on the consensus page. I still agree with making people
learn from the link.

* It is good that, when there is little feedback, you have pushed it.
Seeds for Change say: take “sufficient time”, but IMHO you did and
more time would not have helped. Also you had already taken steps
like writing to guix-devel and generally applied the Seeds’
recommendations.

Regards,
Florian
M
M
Maxim Cournoyer wrote on 11 Apr 2023 17:58
(name . pelzflorian (Florian Pelz))(address . pelzflorian@pelzflorian.de)(address . 62246@debbugs.gnu.org)
87fs96mmv5.fsf@gmail.com
Hi Florian,

"pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de> writes:

Toggle quote (36 lines)
> Hi Maxim and all.
>
> Maxim added to doc/contributing.texi:
>> It is expected from all contributors, and even more so from
>> committers, to collaborate in a consensus decision making
>> fashion. To learn what consensus decision making means and
>> understand its finer details, you are encouraged to read
>> @url{https://www.seedsforchange.org.uk/consensus}.
>
> Only now, that it is already pushed, have I taken the time to read
> (or, at some point, skim) the link.
>
> I just want to acclaim:
>
> * I agree with the addition of this kind of writing.
>
> * Seeds for Change is more politically left than I first expected, and
> the consensus sub-page uses not only examples that chime well with
> free software and Outreachy, but also one-sided views on issues like
> housing. Perhaps such examples will prompt dissent in the future.
>
> It would have been an option (a worse option) to add consensus
> decision making to the manual without linking to such an extensive
> text.
>
> Nonetheless, the way it is written, the manual asks for agreement
> with consensus decision making, not with Seeds for Change or the
> examples on the consensus page. I still agree with making people
> learn from the link.
>
> * It is good that, when there is little feedback, you have pushed it.
> Seeds for Change say: take “sufficient time”, but IMHO you did and
> more time would not have helped. Also you had already taken steps
> like writing to guix-devel and generally applied the Seeds’
> recommendations.

Glad you found it pertinent. I had read the whole thing for the first
time, and found it had useful tricks or suggestions, and was good at
clearing any misunderstandings I had about consensus decision making.

I hope others find it useful too!

--
Thanks,
Maxim
?