diff mbox series

[bug#62246] doc: Add a reference to a page explaining consensus decision making.

Message ID 20230317202234.25156-1-maxim.cournoyer@gmail.com
State New
Headers show
Series [bug#62246] doc: Add a reference to a page explaining consensus decision making. | expand

Commit Message

Maxim Cournoyer March 17, 2023, 8:22 p.m. UTC
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(-)


base-commit: 933051281fbed0ae71bd40c24a701faf2a02791c

Comments

Ludovic Courtès March 26, 2023, 9:35 p.m. UTC | #1
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!

Ludo’.
Maxim Cournoyer March 28, 2023, 3:15 p.m. UTC | #2
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.
diff mbox series

Patch

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