From f731fccbcbeff04ac8fd0c3f8199b704a84ff3da Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Thu, 12 Sep 2024 23:24:41 +0200 Subject: [PATCH 1/4] Add a template for the core developer nomination poll --- core-developers/become-core-developer.rst | 42 +++++++++++++++++++++-- 1 file changed, 39 insertions(+), 3 deletions(-) diff --git a/core-developers/become-core-developer.rst b/core-developers/become-core-developer.rst index a97cd6bce..8a0ae06f4 100644 --- a/core-developers/become-core-developer.rst +++ b/core-developers/become-core-developer.rst @@ -28,11 +28,12 @@ Gaining commit privileges After a candidate has demonstrated consistent contributions, commit privileges are granted through these steps: -#. A core developer (submitter, usually the mentor) starts a poll in the - `Committers category`_ on the `Python Discourse`_. +#. A core developer (submitter, usually the mentor) starts a poll + (see the :ref:`template ` below) in + the `Committers category`_ on the `Python Discourse`_. - open for 7 days - - results shown upon close + - results shown only upon closing #. If the candidate receives at least two-thirds positive votes when the poll closes (as per :pep:`13`), the submitter `emails the steering council @@ -59,6 +60,41 @@ are granted through these steps: were in the form of a separate post on the already open topic with the poll. +Poll template +============= + +.. _coredev-template: + +While Discourse uses Markdown for formatting, the poll functionality is +custom and somewhat resembles BBcode. There's a creator for polls in the +UI (click the Cog icon in the edit box toolbar and choose "Build Poll"). +Make sure to choose "Show Results... When the poll is closed". + +Alternatively, here is a template for a poll that you can copy: + +.. code-block:: bbcode + + [poll type=regular results=on_close public=false chartType=bar groups=committers close=2024-07-15T21:15:00.000Z] + * Promote Basil Fawlty + * Do not promote + [/poll] + +.. raw:: html + + + .. _Code of Conduct: https://policies.python.org/python.org/code-of-conduct/ .. _Committers category: https://discuss.python.org/c/committers/5 .. _Python Discourse: https://discuss.python.org From d2ec1c7557b9f4b42776d1746beb4717d95fe671 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Fri, 13 Sep 2024 10:54:41 +0200 Subject: [PATCH 2/4] Apply suggestions from code review Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Jelle Zijlstra --- core-developers/become-core-developer.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/core-developers/become-core-developer.rst b/core-developers/become-core-developer.rst index 8a0ae06f4..a681370ac 100644 --- a/core-developers/become-core-developer.rst +++ b/core-developers/become-core-developer.rst @@ -67,7 +67,7 @@ Poll template While Discourse uses Markdown for formatting, the poll functionality is custom and somewhat resembles BBcode. There's a creator for polls in the -UI (click the Cog icon in the edit box toolbar and choose "Build Poll"). +UI (click the cog icon in the edit box toolbar and choose "Build Poll"). Make sure to choose "Show Results... When the poll is closed". Alternatively, here is a template for a poll that you can copy: @@ -83,14 +83,13 @@ Alternatively, here is a template for a poll that you can copy: From 96808b5e2cd21e43429fc4fc6737be8d86408c34 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Fri, 13 Sep 2024 10:59:00 +0200 Subject: [PATCH 3/4] Add explanation suggested by Victor Co-authored-by: Victor Stinner --- core-developers/become-core-developer.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/core-developers/become-core-developer.rst b/core-developers/become-core-developer.rst index a681370ac..c777afa86 100644 --- a/core-developers/become-core-developer.rst +++ b/core-developers/become-core-developer.rst @@ -68,9 +68,7 @@ Poll template While Discourse uses Markdown for formatting, the poll functionality is custom and somewhat resembles BBcode. There's a creator for polls in the UI (click the cog icon in the edit box toolbar and choose "Build Poll"). -Make sure to choose "Show Results... When the poll is closed". - -Alternatively, here is a template for a poll that you can copy: +Here's what it outputs, you can copy and paste it for your poll: .. code-block:: bbcode @@ -79,6 +77,12 @@ Alternatively, here is a template for a poll that you can copy: * Do not promote [/poll] +The important options in the poll builder set to get this result: + - Show who voted: **disabled** (`public=false`) + - Limit voting to these groups: **committers** (`groups=committers`) + - Automatically close poll: **in 7 days** (`close=...`) + - Show results: **When poll is closed** (`results=on_close`) + .. raw:: html