update release guide to use contact info · matplotlib/matplotlib@a5c92ce · GitHub
Skip to content

Commit a5c92ce

Browse files
committed
update release guide to use contact info
1 parent 72ef1ac commit a5c92ce

4 files changed

Lines changed: 38 additions & 17 deletions

File tree

doc/_static/mpl.css

Lines changed: 19 additions & 0 deletions

doc/devel/communication_guide.rst

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,6 @@ for example at sprints or when giving official talks or tutorials, and in any
99
community venue managed by Matplotlib.
1010

1111

12-
1312
.. _communication-channels:
1413

1514
Official communication channels
@@ -21,6 +20,8 @@ The following venues are managed by Matplotlib maintainers and contributors:
2120
* chat: `https://matrix.to/#/#matplotlib:matrix.org <https://matrix.to/#/#matplotlib:matrix.org>`_
2221
* blog: https://blog.scientific-python.org/
2322

23+
.. _social-media:
24+
2425
Social media
2526
------------
2627

@@ -38,12 +39,14 @@ Official accounts
3839
* https://www.youtube.com/matplotlib
3940

4041

42+
.. _mailing-lists:
43+
4144
Mailing lists
4245
----------------
4346

44-
* https://mail.python.org/mailman/listinfo/matplotlib-announce
45-
* https://mail.python.org/mailman/listinfo/matplotlib-users
46-
* https://mail.python.org/mailman/listinfo/matplotlib-devel
47+
* `matplotlib-announce@python.org <https://mail.python.org/mailman/listinfo/matplotlib-announce>`_
48+
* `matplotlib-users@python.org <https://mail.python.org/mailman/listinfo/matplotlib-users>`_
49+
* `matplotlib-devel@python.org <https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
4750

4851
.. _social-media-coordination:
4952

doc/devel/release_guide.rst

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -455,22 +455,20 @@ Due to branch protections for the ``main`` branch, this is merged via a standard
455455
request, though the PR cleanliness status check is expected to fail. The PR should not
456456
be squashed because the intent is to merge the branch histories.
457457

458-
Announcing
459-
==========
460-
461-
The final step is to announce the release to the world. A short
462-
version of the release notes along with acknowledgments should be sent to
463-
464-
- matplotlib-users@python.org
465-
- matplotlib-devel@python.org
466-
- matplotlib-announce@python.org
458+
Publicize release
459+
=================
467460

468-
In addition, announcements should be made on social networks (e.g., Twitter via the
469-
``@matplotlib`` account, any other via personal accounts).
461+
The final step is to announce the release to the world:
470462

471-
Add a release announcement to the ``mpl-brochure-site`` "News" section of
472-
``docs/body.html``, linking to the discourse page for the announcement.
463+
.. rst-class:: checklist
473464

465+
* Send a short version of the release notes and acknowledgments to all the :ref:`mailing-lists`
466+
* Post highlights and link to :ref:`What's new <release-notes>` on the
467+
active :ref:`social media accounts <social-media>`
468+
* Add a release announcement to the "News" section of
469+
`matplotlib.org <https://github.com/matplotlib/mpl-brochure-site>`_ by editing
470+
``docs/body.html``. Link to the auto-generated announcement discourse post,
471+
which is in `Announcements > matplotlib-announcements <https://discourse.matplotlib.org/c/announce/matplotlib-announce/10>`_.
474472

475473
Conda packages
476474
==============

doc/users/release_notes.rst

Lines changed: 1 addition & 0 deletions

0 commit comments

Comments
 (0)