---
tags: NumPy
---

# 2024-12-16 NumPy Documentation Team meeting

- Time: 7 pm UTC
- Join via Zoom: https://numfocus-org.zoom.us/j/85016474448?pwd=TWEvaWJ1SklyVEpwNXUrcHV1YmFJQT09 (To dial in, find your local number: https://numfocus-org.zoom.us/u/kbRSNdYfoZ)
- [NumPy community events calendar](https://scientific-python.org/calendars/)
- [Documentation issues](https://github.com/numpy/numpy/labels/04%20-%20Documentation)
- [Documentation brainstorming document](https://hackmd.io/RdtnQZpLRZqgNRe4gaJ0SA) - anything that is not yet ready for an issue or PR or needs a discussion
- [Documentation team meetings notes archive](https://github.com/numpy/archive/tree/main/docs_team_meetings)
- [Community meetings notes archive](https://github.com/numpy/archive/tree/main/community_meetings)
- [Triage meetings notes archive](https://github.com/numpy/archive/tree/master/triage_meetings)
- Next meeting:

### Useful links

- Getting started with building documentation: https://numpy.org/devdocs/dev/howto_build_docs.html
- How to contribute to the NumPy documentation: https://numpy.org/devdocs/dev/howto-docs.html

### Topics Discussed
- PDF version of NumPy Documentation (see some details under New Topics below)
- Leveraging Python Conferences to help attendeed get onboarded to NumPy. Handouts needed at such events.
- Encouraging students and other NumPy users to consider contributing examples as tutorials. See https://numpy.org/numpy-tutorials/

### Code of Conduct

We want to take a moment to remind you that this meeting is meant to be welcoming and inclusive. It's important for us to have a healthy community. Like all NumPy spaces, and everyone participating in them, this meeting will follow our [Code of Conduct](https://numpy.org/code-of-conduct/). If you haven't read it yet, please take some time to do so later on as it already applies to you. For now, in short, please be kind and generous towards one another.

If you see violations, take a screenshot, intervene in a respectful manner, and report it to the CoC Committee via email. For more information, refer to the Reporting Guidelines section on https://numpy.org/code-of-conduct/.

**Present:**

**Notes taken by:**

## Standing topics

- [name=inessa] Presentation topics for NumPy Newcomers’ Hour
To suggest a topic for future presentations, leave a comment in this tracking issue: https://github.com/numpy/archive/issues/58.
- Short form content?

- [name=Inessa & Melissa] [Documentation user stories](https://github.com/numpy/numpy/issues/22089)
*Feel free to add yours!*

- Inessa: issues related to the NumPy educational content:
https://github.com/numpy/archive/issues/55
If you’d like to work on any of them, leave a comment on GitHub (below the relevant issue).

- Tracking inactive PRs: https://github.com/orgs/numpy/projects/6
(help with triaging is welcome!)

## Follow-up from last meeting / discussions
- Doxygen + Breathe: Do we need it anymore? https://github.com/numpy/numpy/issues/27610
- Find out places where Doxygen is still used and original motivation for adding it.
- How are C++ docstrings rendered if at all?

- GSOD 2024 Updates: Completing the ["How to Contribute to NumPy" comics](https://heyzine.com/flip-book/3e66a13901.html):
- Nov 18: Final stretch! Uploading the comics to the NumPy website.
- https://github.com/numpy/numpy.org/pull/795
- Final case study: https://github.com/numpy/numpy/wiki/Google-Season-of-Docs-2024:-NumPy-case-study

- 21 Oct: We briefly discussed need for PDF. Kakaire's take is that, a) in his community at his university in Uganda, everyone has internet access and b) many other projects in the NumPy ecosystem have also dropped pdf output
- Further discussion at https://github.com/numpy/numpy/issues/27573

## New topics

- [name=Melissa] PDF builds of the docs [issue #27573](https://github.com/numpy/numpy/issues/27573)
- Tectonic https://github.com/tectonic-typesetting/tectonic
- Maybe automate the release docs?
- [name=Melissa] NumPy codebase docs [issue #27926](https://github.com/numpy/numpy/issues/27926)
- Maybe related to https://github.com/numpy/numpy/issues/27966

### Let's connect and keep the conversation going!
Join the NumPy contributor community **Slack workspace**: https://join.slack.com/t/numpy-team/shared_invite/zt-1gokbq56s-bvEpo10Ef7aHbVtVFeZv2w

Sign up to the NumPy **mailing list**: mail.python.org/mailman/listinfo/numpy-discussion

Subscribe to the NumPy **YouTube** channel: https://www.youtube.com/c/NumPy_team

Follow us on **Twitter**: [@numpy_team](https://twitter.com/numpy_team)

Follow us on **LinkedIn**: https://www.linkedin.com/company/numpy/

---
Remember to archive this file by committing it to
[https://github.com/numpy/archive/tree/main/docs_team_meetings](https://github.com/numpy/archive/tree/main/docs_team_meetings)