|
| 1 | +# Documentation Community Team Meeting (October 6, 2026) |
| 2 | + |
| 3 | +## Roll call |
| 4 | + |
| 5 | +(Name / `@GitHubUsername` *[/ Discord, if different]*) |
| 6 | +- Ned Batchelder / `@nedbat` |
| 7 | +- Ryan Duve / `@ryan-duve` |
| 8 | +- Velda Kiara / `@veldakiara` |
| 9 | +- Bhuvansh / `@BHUVANSH855` |
| 10 | +- Keith / `@KeithTheEE` |
| 11 | + |
| 12 | + |
| 13 | +## Introductions |
| 14 | + |
| 15 | +New attendees were present, and a round of introductions was made. |
| 16 | + |
| 17 | + |
| 18 | +## Reports and celebrations |
| 19 | + |
| 20 | +- [Python 3.15](https://docs.python.org/3.15/) is nearly here, it's awesome, and the frequent releases, upgrade pipeline, and issue management allows for the grace to pause the schedule a touch to validate that improvements act as improvements for as much of the python userbase as possible. |
| 21 | + |
| 22 | + |
| 23 | +## Discussion |
| 24 | + |
| 25 | +- [Bhuvansh] On behalf of our project team, I want to discuss the [python-docs-pa](https://github.com/BHUVANSH855/python-docs-pa) project, the Punjabi (India) translation of the Python Documentation. The project is complete according to the core requirements, and we would like to discuss the next steps for getting the translation included in the official Python Documentation. The project has also been approved by Maciek and is now waiting for a core developer to take this forward. |
| 26 | + - [Ryan] I had spoken to Bhuvansh over last month about this and he's interested in getting this addressed on today's call. Unstable internet service may affect ability to join by video/voice. |
| 27 | +- [Keith] Pulling from the prior meeting, it'd be nice to cover the process of how to review a PR |
| 28 | + - [Velda] Are there priority issues, how do you look for something to work on. |
| 29 | + - [Ryan] One way is to look based on activity, if something hasn't been looked at too often I can ask a clarifying question to move it along |
| 30 | + - [Ned] [Three Day Issues](https://nedbat.github.io/nedbat_dinghy/3day-docs.html) A personal project to help track recent github items |
| 31 | + - [documentation issues on github](https://github.com/python/cpython/issues?q=is%3Aissue+is%3Aopen+label%3Adocs) |
| 32 | + - [Ned] With new eyes you bring, you can point out what you're confused by to highlight what's confusing in the guide itself and related material you come across. |
| 33 | + - [Docs Community](https://github.com/python/docs-community) Was found by a Google search + searching the Python org. Could there be a way to add a thing that links to the devguide to direct to a common source of truth. Github let's an org create a custom readme, python's github org does not have one |
| 34 | +- [Velda] Are there interesting issues you've reviewed before, so I can read through the comments on a review |
| 35 | +- [Ryan] Looking at issues. Start by going to issues, then look at [`label:docs`](https://github.com/python/cpython/issues?q=is%3Aissue+is%3Aopen+label%3Adocs). |
| 36 | + - One thing for me: I don't know what to respond to, so I often look at issues that don't have a ton of comments on it |
| 37 | + - Starting on issue [#158681](https://github.com/python/cpython/issues/158681) as an example, read through it |
| 38 | + - Then after reading it, I'll often look at the user's account. If they're very new user, I'll add a welcome comment. If they're a core team member, it's possible I'll not know as much so I might not be able to offer helpful suggestions to their PR/Issue. This helps me select an issue/PR to focus on. |
| 39 | + - Moving on to the Pull Request: I look to see if it is a documentation change. I see if it's correct, and if it's helpful. I like to ask leading questions which, if it has an answer, will help increase the chance that the pr is going to be merged. |
| 40 | + - Sometimes if there's a concern about the person's interest in the issue, I'll immediately ask a question. This helps gauge their interest in actually improving their PR. |
| 41 | + - Github Views: might help add filters so you can filter for issues/PRs which have specifics you're interested in, be it issues not submitted by core team, PRs with a keyword, etc. |
| 42 | + |
0 commit comments