updated communications guidelines with current information

story645 · timhoffm · story645 · commit 22e2fe51eb3f · 2023-11-01T04:06:20.000-04:00
Fix section title formatting
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
@@ -8,28 +8,38 @@ These guidelines are applicable when acting as a representative of Matplotlib,
 for example at sprints or when giving official talks or tutorials, and in any
 community venue managed by Matplotlib.
 
+
+
 .. _communication-channels:
 
 Official communication channels
 ===============================
 The following venues are managed by Matplotlib maintainers and contributors:
 
-* https://github.com/matplotlib/matplotlib
-* https://discourse.matplotlib.org/
-* https://gitter.im/matplotlib/
-* https://github.com/matplotlib/matplotblog
+* library and docs: https://github.com/matplotlib/matplotlib
+* forum: https://discourse.matplotlib.org/
+* chat: `https://matrix.to/#/#matplotlib:matrix.org <https://matrix.to/#/#matplotlib:matrix.org>`_
+* blog: https://blog.scientific-python.org/
 
-
-Social Media
+Social media
 ------------
 
+Active social media
+^^^^^^^^^^^^^^^^^^^
+
 * https://twitter.com/matplotlib
 * https://instagram.com/matplotart/
+
+Official accounts
+^^^^^^^^^^^^^^^^^
+* https://bsky.app/profile/matplotlib.bsky.social
+* https://fosstodon.org/@matplotlib
 * https://www.tiktok.com/@matplotart
+* https://www.youtube.com/matplotlib
 
 
 Mailing lists
-----------------
+-------------
 
 * https://mail.python.org/mailman/listinfo/matplotlib-announce
 * https://mail.python.org/mailman/listinfo/matplotlib-users
@@ -39,83 +49,161 @@ Mailing lists
 
 Social media coordination
 -------------------------
-team mailing list: matplotlib-social@numfocus.org
-public chat room: https://gitter.im/matplotlib/community
+* Team mailing list: matplotlib-social@numfocus.org
+* Public chat room: `https://matrix.to/#/#matplotlib_community:gitter.im <https://matrix.to/#/#matplotlib_community:gitter.im>`_
+
+
+Maintenance
+-----------
+
+If you are interested in moderating the chat or forum or accessing the social
+media accounts:
+
+* Matplotlib maintainers should reach out to the `community-manager`_.
+
+* Everyone else should send an email to matplotlib-social-admin@numfocus.org:
+
+  * Introduce yourself - github handle and participation in the community.
+  * Describe the reason for wanting to moderate or contribute to social.
+
 
 Content guidelines
-====================
+==================
+
 Communication on official channels, such as the Matplotlib homepage or on
-Matplotlib social accounts, should conform to the following standards:
-
-- be primarily about Matplotlib, 3rd party packages, and visualizations made with Matplotlib
-- also acceptable topics: Python, Visualization, NumFOCUS libraries
-- no gratuitous disparaging of other visualization libraries and tools; criticism is acceptable so long as it serves a constructive purpose
-- follow visualization communication best practices
-    - don't share non-expert visualizations when it could be harmful
-      - put on meeting agenda when answer isn't clearly to hold off on sharing.
-    - clearly state when the visualization data/conclusions cannot be verified
-      - do not rely on machine translations for sensitive visualizations
-    - example: https://twitter.com/matplotlib/status/1244178154618605568
-- verify sourcing of content (especially on instagram & blog)
-    - Instagram/blog: ensure mpl has right to repost/share content
-    - make sure content is clearly cited
-        - example: a tutorial using someone else’s example clearly cites the original source
-- Limited self/corporate promotion is acceptable, but should be no more than about a quarter of the content of the blog/discourse post.
-- if you think content is borderline, ask on the :ref:`_social-media-coordination` channels before publishing it
-- acceptable image guide:
-    - keep it geared towards science/data visualization, and non-controversial images
-    - must be conform to the guidelines of all sites it may be posed on:
-        - https://help.twitter.com/en/rules-and-policies/twitter-rules
-        - https://help.instagram.com/477434105621119
+Matplotlib social accounts, should conform to the following standards. If you
+are unsure if content that you would like to post or share meets these
+guidelines, ask on the :ref:`social-media-coordination` channels before posting.
+
+General guidelines
+------------------
+
+* Focus on Matplotlib, 3rd party packages, and visualizations made with Matplotlib.
+* These are also acceptable topics:
+
+  * Visualization best practices and libraries.
+  * Projects and initiatives by NumFOCUS and Scientific Python.
+  * How to contribute to open source projects.
+  * Projects, such as scientific papers, that use Matplotlib.
+
+* No gratuitous disparaging of other visualization libraries and tools, but
+  criticism is acceptable so long as it serves a constructive purpose.
+
+* Follow communication best practices:
+
+  * Do not share non-expert visualizations when it could cause harm:
+
+    * e.g. https://twitter.com/matplotlib/status/1244178154618605568
+
+  * Clearly state when the visualization data/conclusions cannot be verified.
+  * Do not rely on machine translations for sensitive visualization.
+
+* Verify sourcing of content (especially on instagram & blog):
+
+  * Instagram/blog: ensure mpl has right to repost/share content
+  * Make sure content is clearly cited:
+
+    * e.g. a tutorial reworking an example must credit the original example
+
+* Limited self/corporate promotion is acceptable.
+
+  * Should be no more than about a quarter of the content.
+
+Visual media guidelines
+-----------------------
+
+Visual media, such as images and videos, must not violate the
+:ref:`code of conduct <code_of_conduct>`, nor any platform's rules.
+Specifically:
+
+* Visual media must conform to the guidelines of all sites it may be posted on:
+
+  * https://help.twitter.com/en/rules-and-policies/twitter-rules
+  * https://help.instagram.com/477434105621119
+
+* Emphasize the visualization techniques demonstrated by the visual media.
+* Clearly state that sharing is not an endorsement of the content.
+
+  * e.g. bitcoin related visualizations
 
 Accessibility
--------------
-Images in communications should be as accessible as possible:
+^^^^^^^^^^^^^
 
-- add alt text to images and videos when the platform allows
-    - https://webaim.org/techniques/alttext/
-    - https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81
-- warn on bright, strobing, images & turn off autoplay if possible
-- for images made by the social media team:
-  - make graphic perceivable to people who cannot perceive color well, due to color-blindness or low vision
-  - do not make bright, strobing images
-  - more guidelines at https://webaim.org/techniques/images/
+Visual media in communications should be made as accessible as possible:
 
+* Add alt text to images and videos when the platform allows:
 
+  * `alt text for data viz <https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81>`_
+  * `general alt text guide <https://webaim.org/techniques/alttext/>`_
 
-Social media account information
-================================
+* Warn on bright, strobing, images & turn off autoplay if possible.
+* For images and videos made by the social media team:
+
+  * Make graphic perceivable to people who cannot perceive color well due to
+    color-blindness, low vision, or any other reason.
+
+  * Do not make bright, strobing images.
+  * More guidelines at https://webaim.org/techniques/images/.
 
-Behavior
---------
-When acting as a representative of the library, keep responses polite, and assume
-user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/)
+
+Social media
+============
+
+Please follow these guidelines to maintain a consistent brand identity across
+platforms.
 
 Persona
 -------
 On social media, Matplotlib:
 
-* Is a sentient visualization library, so talks about itself as a we, us, our, and it. Avoids talking about itself in the 3rd person.
-* Is very earnest, eager to please, and aims to be patient & painfully oblivious to snark and sarcasm.
-* Gets over-excited over shiny visualizations - lots of emojis and the like - and encourages folks to share their work.
-* Highlights various parts of the library, especially the more obscure bits and bobbles.
-* Acknowledges that it is a sometimes frustrating tangle of bits & bobbles that can confuse even the folks who work on it & signal boosts their confuzzlment.
+* Acts as a sentient visualization library, so talks about itself as a we, us,
+  our, and it. Avoids talking about itself in the 3rd person. Never uses 1st person.
+* Is very earnest, eager to please, and aims to be patient & painfully oblivious
+  to snark and sarcasm.
+* Gets over-excited over shiny visualizations - lots of emojis and the like -
+  and encourages folks to share their work.
+* Highlights various parts of the library, especially the more obscure bits and
+  bobbles.
+* Acknowledges that it is a sometimes frustrating tangle of bits & bobbles that
+  can confuse even the folks who work on it & signal boosts their confuzzlment.
+
+
+Behavior
+--------
+When acting as a representative of the library, keep responses polite and assume
+user statements are in good faith unless they violate the :ref:`code of conduct <code_of_conduct>`.
 
 Social graph
 ------------
-- only follow organizations/projects - mostly NumFocus projects
-    - especially 3rd party packages
-    - should at least be visualization related
-    - sponsors are also acceptable
-- do not follow individual accounts for any reason (even maintainers/project leads/Guido!)
-
-Recurrent social campaigns
---------------------------
-
-- Release Announcements
-    - Highlight new features & major deprecations
-    - Link to download/install instructions
-    - Ask folks to try it out.
-- signal  boost third party packages
-- GSOC work during GSOC recruiting and work times
-- John Hunter Excellence in Plotting, submission and winners
+
+Only follow **organizations and projects**, do not follow individual accounts for
+any reason, even maintainers/project leads/famous Python people!
+
+Following these types of accounts is encouraged:
+
+* NumFocus and Scientific Python projects
+* 3rd party packages
+* Visualization related projects and organizations
+* Open Source community projects
+* Sponsors
+
+Recurring campaigns
+-------------------
+
+Typically the social media accounts will promote the following:
+
+* Matplotlib releases:
+
+  * Highlight new features & major deprecations
+  * Link to download/install instructions
+  * Ask folks to try it out.
+
+* `third party packages <https://matplotlib.org/mpl-third-party/>`_
+* NumFocus/Scientific Python/open source visualization project releases
+* GSOC/GSOD recruiting and progress
+
+Retired campaigns
+^^^^^^^^^^^^^^^^^
+* John Hunter Excellence in Plotting, submission and winners
+
+.. _community-manager: https://matplotlib.org/governance/people.html#deputy-project-leads
diff --git a/doc/users/project/code_of_conduct.rst b/doc/users/project/code_of_conduct.rst
@@ -1,4 +1,4 @@
-.. code_of_conduct
+.. _code_of_conduct:
 
 ====================================
 Contributor Covenant Code of Conduct

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. code_of_conduct`
	`1`	`+.. _code_of_conduct:`
`2`	`2`
`3`	`3`	`====================================`
`4`	`4`	`Contributor Covenant Code of Conduct`