|
1 |
| -# Documentation Community Team Meeting (April 2025) |
| 1 | +# Documentation Community Team Meeting (1 April 2025) |
2 | 2 |
|
3 | 3 | ## Roll call
|
4 | 4 |
|
|
77 | 77 |
|
78 | 78 | - Blaise noted he will host a 90-min ensemble session for intermediate to advanced contributors this Friday,
|
79 | 79 | as an exercise to get folk used to using Python codebase.
|
80 |
| -- The topic will be related to https://github.com/python/cpython/issues/127833 but there is no rigid agenda. |
81 |
| -- Invitation: https://calendar.app.google/5hjYyVRSjJN5MwdEA |
| 80 | +- The topic will be related to [python/cpython#127833](https://github.com/python/cpython/issues/127833) but there is no rigid agenda. |
| 81 | +- Invitation: <https://calendar.app.google/5hjYyVRSjJN5MwdEA> |
82 | 82 |
|
83 | 83 | ### Editorial Board update & documentation audits
|
84 | 84 |
|
85 | 85 | - Ned gave a brief update from the Editorial Board.
|
86 | 86 | - Joanna Jablonski (editor, *Real Python*) and Savannah Ostrowski (core developer) are conducting *documentation audits*.
|
87 | 87 | - These are a formal approach to assessing gaps in documentation and approaching from disciplined first principles.
|
88 |
| -- The pair are planning an audit of the *argparse* docs, with the indent to repeat the process elsewhere in the documentation. |
| 88 | +- The pair are planning an audit of the *argparse* docs, with the intent to repeat the process elsewhere in the documentation. |
89 | 89 |
|
90 | 90 | ### Potential PR process improvements
|
91 | 91 |
|
|
117 | 117 |
|
118 | 118 | ### Synchronous contributions
|
119 | 119 |
|
120 |
| -- Blaise noted that the experience of the Pycon sprints was valuable, being able to do work, get stuck, and then carry on. |
| 120 | +- Blaise noted that the experience of the PyCon US sprints was valuable, being able to do work, get stuck, get expert help, and then carry on. |
121 | 121 | These settings give the freedom to interrupt and get help from more experienced contributors.
|
122 |
| -- Technical writers, such as those in the *Write the Docs* slack, would like to help, but don't know where to begin, and a session like this could help. |
| 122 | +- Technical writers, such as those in the [*Write the Docs* Slack](https://www.writethedocs.org/slack/), would like to help, but don't know where to begin, and a session like this could help. |
123 | 123 | - Are there changes we can make to improve the 'just start writing' experience for technical writers, who aren't necessarily programmers?
|
124 | 124 |
|
125 | 125 | ### PR templates
|
|
0 commit comments