# Matplotlib Documentation Working Group

A regular sync meeting to discuss documentation
Everyone is welcome to contribute to conversations.

contact: https://matrix.to/#/#matplotlib_community:gitter.im

https://numfocus-org.zoom.us/j/83834096272?pwd=NU9zU0pJV0lXd1ZCNEVLN1RVc0poUT09#success

---
# 10/3/2025

# 9/19/2025

[Logo guide review](https://github.com/jeromefv/matplotlib/tree/logo_guide)
- Weird background color difference for SVG compared to dark mode background
- `rgb(33,37,41)`

    .dark-mode-card.sd-card-body{
    background-color: rgb(33,37,41)
} 

    .. card::
        :card-body:dark-mode-card

#library functions for generating logo

MPL_BLUE = {'light':'#11557c', 'dark':'#65baea'}

def create_icon_axes(...., mode):
     with plt.rc_context('axes.edgecolor':MPL_BLUE[mode],...
                        
def make_logo(..., mode='light'):
    ...
    create_icon_axes(...., mode)                         
                        
# user code -> user makes logo
make_logo(height, ...., mode='dark')
make_logo(height, ...., mode='light') 
                        
""""""
                    
Tasks for draft PR
- [ ] Revert logo to unfilled background original
- [ ] Explain issue with dark/light mode and SVG files
- [ ] Update logo example page to show dark mode for PR

# 9/5/2025

Hi, Hannah asked me to cover this meeting, but don't think I have host on the normal zoom, so trying to figure things out
- Kyle

Temp meeting link for today: https://numfocus-org.zoom.us/j/86027343859

- [ ] Update matplotlib logo generation script for dark text logo image with updated color `#65baea`
    - [ ] update logo example too 

# 8/22/2025
Jerome and Hannah

- [ ] Release notes media support
    - [ ] Fonts
    - [ ] multi-norm
- [ ] logo guide
    - defer usage guidance to [NumFocus guide](https://numfocus.org/trademark-guidelines) (e.g. "you can use for x")
    - include formatting guidance - keep ratio, don't change colors, etc
    - swatch colors
        - might be able to use list table or [sphinx design grids](https://sphinx-design.readthedocs.io/en/pydata-theme/)
            - [raw html directive](https://stackoverflow.com/a/50566700)
        - maybe badges https://pydata-sphinx-theme.readthedocs.io/en/stable/
    - show wordmark and non-wordmark logos
    

.. grid:: # of columns

.. grid-item::

..raw::html

<svg width="200" height="200">
<circle cx="100" cy="100" r="50" fill="blue" stroke="black" stroke-width="2"/></svg>

# 8/08/2025

## Logo guide
https://github.com/jeromefv/matplotlib/tree/logo_guide
- [ ] Get SVG files from generating logo

# 7/11/2025

SciPy check in w/ Jerome

# 6/27/2025

Alexandra and Jerome 
- combine the docstring and usage questions 


# 6/13/2025

Jerome and Hannah attended 

# 5/30/2025

Jerome
- Survey PRs updated
- Interactivity overview
    - High level and ELI5 for interactivity
        - Pull up the repository (https://github.com/story645/pydata_nyc_2023) and go through the notebooks
    - Real world data to use
    - SciPy practice and usage
        - Kyle, MPL data containers, custom interactivity and spending a lot of time with this feature

Alex
- Question 1
    - Update time frame to 1 year to also include project-based work
    - Hannah mentions people can revisit Matplotlib after a long hiatus 
    - Ad-hoc usage to cover use cases?
        - short bursts vs ongoing development work 
- Explicitly ask how they find out about new features?
- How will results serve goals for the project?
    - Tim on steering committee, 
    - information architecture decision making validation
        - Tutorials vs user guides vs galleries
        - Collecting data to make teaching approach decisions

# 5/16/2025
- Jerome
    - Survey to go out before school, at a conference
    - Timeline for SciPy, September for US school, or november for PyData NYC
    - [x] Draft new survey questions as PR, add Tammy as co-author
- Interactivity Guide
    - Kyle going to be at SciPy
    - Tutorial from Hannah as skeleton to start, get ideas from 
- Logo guide
    - https://matplotlib.org/devdocs/#about-us
    - `https://github.com/matplotlib/matplotlib/tree/main/doc/project`
- Pranav & Anton
    - https://github.com/matplotlib/matplotlib/pull/27937 
    - want to sort out GCContext object first b/c would make 27937 easier
        - next step is to write proposal PR

# 5/2/2025

## Survey timeline
- Getting questions as draft on GitHub for repo
- Alexandra and Francisco to review
- Aiming for sharing by SciPy (Jul 8-14) and PyCon NYC (November)

### SciPy
https://www.scipy2025.scipy.org/sprints
https://ti.to/scipy/scipy2025

## Interactivity guide
- Stageable in components for the work
    - Chunks and scaffolding for this content

# 4/18/2025

### Jerome
Documentation work to consider
- [Logo usage guide](https://github.com/matplotlib/matplotlib/issues/18716)
    - Numfocus trademark guidelines
- Add survey information and upload folder of materials from 2020 survey
    - Pull request from current 2020
    - CSV → anonymize the information, remove anythign that could be identifying
- [[Doc]: document "out-of-the-box" interactivity](https://github.com/matplotlib/matplotlib/issues/28722)
    - Pull together the interactivity tools as a tutorial for making a dashboard
        - Add a box as an example → definitions and then smaller features that build 
    - Out of the box interactivity, tutorials to demonstrate how to use the functionality
- [Improve install guidance](https://github.com/matplotlib/matplotlib/issues/29775)
    - Suggestions to improve based on current skillset as technical writer



# 3/21/2025 

- alexandra: refreshing matplotlib skills (shout out for contributing ease)

# 2/7/2025

- impromptu new contributor meeting
    - software developer, c++/Python, open cv user 

# 9/6/2024

- Jerome is primarily drafting questions
    - has 9, potentially maintainers suggest 10th
    - scales will be broken down into descriptive/context , so 1 has shared meaning etc
    - working on the descriptions for answers
- Tammy is primarily on the justification

- helpful: one to five, temperature gauge, how do you feel about the docs? sentiment
- value: short response, when do you use the docs? -> helping folks, building something, studying, sharing, etc, other: open response, substance  

- [x] [name=hannah] follow up w/ scientific Python about plausible downloads

## next steps
- once survey is approved, figure out distribution channels
    - social media: 
        - linked in - ask projects/numfocus to share out
        - reddit 
        - banner on webpage 
        - other social media: insta/ticktok/bluesky/X (mastodon?)
        - possibly pydata nyc

## List of questions and available responses
1. How often do you use the Matplotlib documentation?
Scale of 1-5
1. How helpful has the Matplotlib documentation been for your tasks?
Scale of 1-5
1. What is the value of Matplotlib documentation for your tasks?
Selection: summary options
1. What resources do you use to supplement your experience with Matplotlib documentation?
Rank choice responses
1. What would you like to see change in Matplotlib’s documentation?
Table response
1. What is your background for using Matplotlib?
Selection: expertise and use case contexts
1. When you arrive at your intended documentation page for Matplotlib, how likely are you to go to another page?
Scale of 1-5
1. How would you organize the importance of the following documentation categories for Matplotlib?
Rank choice responses
1. Thank you for completing the survey! Any additional feedback is welcome!
Short response, open
1. Open to suggestions

# 8/23/2024

- deciding how to make public/scope of involvement
- design study - what do folks get out of our docs/API, what do they want out of the docs/API
    - https://dscout.com/people-nerds/how-to-design-a-ux-research-survey
- move from describing the audience to audience expectations/reasoning


For next meeting:
- questions + justifications for questions
- broader study goals


# 8/9/2024

_attending_: @story645, @melissawm , @Tgmiller5, @jeromefv

### Notes

 - access to analytics: https://github.com/matplotlib/matplotlib/issues/28696
 - new user survey
    - Jerome and Tammy will discuss old survey - construction/design/roll-out/engagement/etc. 
        
        
# 7/26/2024

- Tammy - My name is Tammy and I am a software tester. My interest is working with data analytics in which I have experience from my past two jobs.