From 047914e1879da663a59b93ff0ba1e6623613549f Mon Sep 17 00:00:00 2001 From: hannah Date: Tue, 10 Dec 2019 18:15:52 -0500 Subject: [PATCH 1/7] onboarding oriented governance docs --- communications_guidelines.md | 39 ++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 communications_guidelines.md diff --git a/communications_guidelines.md b/communications_guidelines.md new file mode 100644 index 0000000..2bea135 --- /dev/null +++ b/communications_guidelines.md @@ -0,0 +1,39 @@ +# Communication Guidelines +These guidelines are applicable when acting as a representitive of Matplotlib (for example at sprints or when giving official talks or tutorials) and on the following community venues managed by matplotlib: +* https://github.com/matplotlib/matplotlib +* https://discourse.matplotlib.org/ +* gitter.im/matplotlib/ +* https://github.com/matplotlib/matplotblog +* twitter.com/matplotlib +* instagram.com/matplotart/ + +## Content Guidelines: +- stick to 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 +- 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 1/4? the content of the blog/discourse post? +- if you think content is borderline, ask before publishing it +- keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/) +- acceptable image guide: + - union of site guidelines favoring caution: + - keep it geared towards science/data visualization, and non-controversial images + - site guidelines: + - https://help.twitter.com/en/rules-and-policies/twitter-rules + - https://help.instagram.com/477434105621119 + +## Recurrent Social Media Campaigns: +- new features during release times +- signal boost third party packages +- GSOC work during GSOC recruiting and work times +- John Hunter Excellence in Plotting, submission and winners + +## Social Media Following Guide: +- 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!) \ No newline at end of file From 4b5872eb313e4e486fad648f623bb083c467d77d Mon Sep 17 00:00:00 2001 From: hannah Date: Fri, 20 Dec 2019 12:05:03 -0500 Subject: [PATCH 2/7] adding https Co-Authored-By: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com> --- communications_guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index 2bea135..3676fbd 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -2,7 +2,7 @@ These guidelines are applicable when acting as a representitive of Matplotlib (for example at sprints or when giving official talks or tutorials) and on the following community venues managed by matplotlib: * https://github.com/matplotlib/matplotlib * https://discourse.matplotlib.org/ -* gitter.im/matplotlib/ +* https://gitter.im/matplotlib/ * https://github.com/matplotlib/matplotblog * twitter.com/matplotlib * instagram.com/matplotart/ @@ -36,4 +36,4 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f - 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!) \ No newline at end of file +- do not follow individual accounts for any reason (even maintainers/project leads/Guido!) From d9dcdb977d504db646bae59b581b36afccf6ff55 Mon Sep 17 00:00:00 2001 From: hannah Date: Fri, 20 Dec 2019 12:05:14 -0500 Subject: [PATCH 3/7] adding https Co-Authored-By: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com> --- communications_guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index 3676fbd..cb1737d 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -5,7 +5,7 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f * https://gitter.im/matplotlib/ * https://github.com/matplotlib/matplotblog * twitter.com/matplotlib -* instagram.com/matplotart/ +* https://instagram.com/matplotart/ ## Content Guidelines: - stick to Matplotlib, 3rd party packages, and visualizations made with Matplotlib From 497db39528e9752c57cb2c6b41e3a636e0c6ba9d Mon Sep 17 00:00:00 2001 From: hannah Date: Fri, 20 Dec 2019 12:05:29 -0500 Subject: [PATCH 4/7] adding https Co-Authored-By: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com> --- communications_guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index cb1737d..40bdeb3 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -4,7 +4,7 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f * https://discourse.matplotlib.org/ * https://gitter.im/matplotlib/ * https://github.com/matplotlib/matplotblog -* twitter.com/matplotlib +* https://twitter.com/matplotlib * https://instagram.com/matplotart/ ## Content Guidelines: From a573d8321c8e3e60b22d7aed428aa68bcfda666e Mon Sep 17 00:00:00 2001 From: hannah Date: Thu, 5 Mar 2020 18:38:06 -0500 Subject: [PATCH 5/7] Update communications_guidelines.md --- communications_guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index 40bdeb3..993136d 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -1,5 +1,5 @@ # Communication Guidelines -These guidelines are applicable when acting as a representitive of Matplotlib (for example at sprints or when giving official talks or tutorials) and on the following community venues managed by matplotlib: +These guidelines are applicable when acting as a representitive of Matplotlib (for example at sprints or when giving official talks or tutorials) and in the following community venues managed by matplotlib: * https://github.com/matplotlib/matplotlib * https://discourse.matplotlib.org/ * https://gitter.im/matplotlib/ @@ -15,7 +15,7 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f - 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 1/4? the content of the blog/discourse post? +- 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 before publishing it - keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/) - acceptable image guide: From d1378a71a481a3e65ab64f8065e908a3621d0e8e Mon Sep 17 00:00:00 2001 From: hannah Date: Mon, 30 Mar 2020 15:56:17 -0400 Subject: [PATCH 6/7] viz best practive + releases updated guide w/ description of what should be in release announcements & guidelines for sharing potentially harmful communications (basically don't). --- communications_guidelines.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index 993136d..fce9f14 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -11,22 +11,33 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f - stick to 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 before publishing it -- keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/) - acceptable image guide: - union of site guidelines favoring caution: - keep it geared towards science/data visualization, and non-controversial images - site guidelines: - https://help.twitter.com/en/rules-and-policies/twitter-rules - https://help.instagram.com/477434105621119 + +## Communication Guidelines +- keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/) ## Recurrent Social Media Campaigns: -- new features during release times +- 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 From 5c00b18b98559ec4b8e45cb1eeee4ff6277daf38 Mon Sep 17 00:00:00 2001 From: Thomas A Caswell Date: Mon, 11 May 2020 18:47:56 -0400 Subject: [PATCH 7/7] DOC: edits from review Co-authored-by: Elliott Sales de Andrade --- communications_guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/communications_guidelines.md b/communications_guidelines.md index fce9f14..34c5cb5 100644 --- a/communications_guidelines.md +++ b/communications_guidelines.md @@ -1,5 +1,5 @@ # Communication Guidelines -These guidelines are applicable when acting as a representitive of Matplotlib (for example at sprints or when giving official talks or tutorials) and in the following community venues managed by matplotlib: +These guidelines are applicable when acting as a representative of Matplotlib (for example at sprints or when giving official talks or tutorials) and in the following community venues managed by Matplotlib: * https://github.com/matplotlib/matplotlib * https://discourse.matplotlib.org/ * https://gitter.im/matplotlib/ @@ -9,7 +9,7 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f ## Content Guidelines: - stick to Matplotlib, 3rd party packages, and visualizations made with Matplotlib -- also acceptable topics: Python, Visualization, Numfocus libraries +- 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