Skip to content

Commit 0f8840f

Browse files
authored
viz best practive + releases
updated guide w/ description of what should be in release announcements & guidelines for sharing potentially harmful communications (basically don't).
1 parent e82c48a commit 0f8840f

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

communications_guidelines.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,33 @@ These guidelines are applicable when acting as a representitive of Matplotlib (f
1111
- stick to Matplotlib, 3rd party packages, and visualizations made with Matplotlib
1212
- also acceptable topics: Python, Visualization, Numfocus libraries
1313
- no gratuitous disparaging of other visualization libraries and tools; criticism is acceptable so long as it serves a constructive purpose
14+
- follow visualization communication best practices
15+
- don't share non-expert visualizations when it could be harmful
16+
- put on meeting agenda when answer isn't clearly to hold off on sharing.
17+
- clearly state when the visualization data/conclusions cannot be verified
18+
- do not rely on machine translations for sensitive visualizations
19+
- example: https://twitter.com/matplotlib/status/1244178154618605568
1420
- verify sourcing of content (especially on instagram & blog)
1521
- Instagram/blog: ensure mpl has right to repost/share content
1622
- make sure content is clearly cited
1723
- example: a tutorial using someone else’s example clearly cites the original source
1824
- Limited self/corporate promotion is acceptable, but should be no more than about a quarter of the content of the blog/discourse post.
1925
- if you think content is borderline, ask before publishing it
20-
- keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/)
2126
- acceptable image guide:
2227
- union of site guidelines favoring caution:
2328
- keep it geared towards science/data visualization, and non-controversial images
2429
- site guidelines:
2530
- https://help.twitter.com/en/rules-and-policies/twitter-rules
2631
- https://help.instagram.com/477434105621119
32+
33+
## Communication Guidelines
34+
- keep responses polite, assume user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/)
2735

2836
## Recurrent Social Media Campaigns:
29-
- new features during release times
37+
- Release Announcements
38+
- Highlight new features & major deprecations
39+
- Link to download/install instructions
40+
- Ask folks to try it out.
3041
- signal boost third party packages
3142
- GSOC work during GSOC recruiting and work times
3243
- John Hunter Excellence in Plotting, submission and winners

0 commit comments

Comments
 (0)