2022-11-21 NumPy Documentation Team meeting

--- tags: NumPy --- # 2022-11-21 NumPy Documentation Team meeting - Time: 4 pm UTC - Join via Zoom: https://us06web.zoom.us/j/85016474448?pwd=TWEvaWJ1SklyVEpwNXUrcHV1YmFJQT09 (To dial in, find your local number: https://us06web.zoom.us/u/ksv5WeoUL) - [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: 2022-12-05 @ 12pm (noon) UTC ### Useful links - Getting started with building documentation: https://www.numpy.org/devdocs/docs/index.html - How to contribute to the NumPy documentation: https://numpy.org/devdocs/dev/howto-docs.html ### 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** *(add your name and GitHub handle)*: Melissa Mendonça (@melissawm), Inessa Pawson (@inessapawson), Ross Barnowski (@rossbar), Matti Picus (@mattip), Sebastian Berg (@seberg), Brigitta Sipőcz (@bsipocz) ## Follow-up from last meeting / discussions - [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. Ross: a "show and tell" by a NumPy maintainer/experienced contributor where they work on an issue or PR in numpy/numpy in real life. Announce topics in a thread to the announcement. Pros: – no preparation is required from a speaker, – showcasing real life scenarios of working on the NumPy code base. Melissa: invite Evgeni to speak about refguide_check. - [name=Inessa & Melissa] [Documentation user stories](https://github.com/numpy/numpy/issues/22089) *Feel free to add yours!* - Sebastian: refguide_check (non)failures on https://github.com/numpy/numpy/pull/22449 - doctests need to be updated - We could take care of this automation for NumPy, and collaborate with AstroPy or some other project that uses doctest-plus. - Timeline: NEP 51 needs to be accepted (next two weeks, possibly). #22449 should be accepeted next. By the end of the year this should be done. - We can work on a solution for this but it's not urgent (not for next release) - Inessa: issues related to the NumPy educational content: https://github.com/numpy/numpy-newsletter/issues/20 https://github.com/numpy/numpy-newsletter/issues/24 https://github.com/numpy/numpy-newsletter/issues/25 https://github.com/numpy/numpy-newsletter/issues/26 If you’d like to work on any of them, leave a comment on GitHub (below the relevant issue). - Inessa: NumPy Newcomers' Hour - November 17th, 2022 Speaker: Ross Barnowski Topic: Maintaining /numpy-tutorials Video recording has been posted on the NumPy YouTube channel: https://youtu.be/A-UCO1F09M4. ## New Topics - Inessa: DEP: Deprecate np.round_: https://github.com/numpy/numpy/issues/22617 - Inessa to submit a PR, include a link to the mailing list announcement, ping Ross for review - Remove after 2 releases - Inessa: DOC: Remove info specific to Python 2 from the latest docs version: https://github.com/numpy/numpy/issues/22635 This is a "sprintable" issue. - Discussion around the "sprint" label. Changing the label from "sprint" to "sprintable" to indicate that this issue isn't reserved for a sprint. - Inessa: Triage guidelines for numpy/numpy Question: where in the documentation should it be placed? Answer: Below: https://numpy.org/doc/stable/dev/reviewer_guidelines.html. Discussion: Perhaps, we should re-organize the document hierarchy of the Contributor Guide. (Open a discussion in a separate issue or PR.) --- ### 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)

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.