|
| 1 | +# Documentation Community Team Meeting (February 3, 2026) |
| 2 | + |
| 3 | +## Roll call |
| 4 | + |
| 5 | +(Name / `@GitHubUsername` *[/ Discord, if different]*) |
| 6 | + |
| 7 | +* Hugo van Kemenade / `@hugovk` |
| 8 | +* Trey |
| 9 | +* Petr Viktorin / `@encukou` |
| 10 | +* Abby |
| 11 | +* Steve |
| 12 | +* Ryan / `@ryan-duve` |
| 13 | +* Ned / `@nedbat` |
| 14 | +* Stan / `@StanFromIreland` |
| 15 | + |
| 16 | + |
| 17 | +## Discussion |
| 18 | + |
| 19 | +* Why don't we just add a manual? |
| 20 | + https://discuss.python.org/t/are-new-python-devs-forgetting-the-zen-of-python-there-should-be-one-and-preferably-only-one-obvious-way-to-do-it/105130/51 |
| 21 | +* [Hugo] Savannah coded a demo to embed a REPL in the browser; Hugo integrated |
| 22 | + it with the docs: https://hugovk-cpython.readthedocs.io/en/pyrepl/tutorial/introduction.html |
| 23 | + * The required changes: https://github.com/python/cpython/compare/main...hugovk:cpython:pyrepl |
| 24 | + * Would this be safe to deploy? It can probably get to the user's cookies, etc. |
| 25 | +* [Ryan] I recently found [A Conceptual Overview of asyncio](https://docs.python.org/3/howto/a-conceptual-overview-of-asyncio.html#a-conceptual-overview-of-asyncio) |
| 26 | + and found it very useful. Does the docs community want more articles like this? |
| 27 | +* [Stan] An Editorial Board issue |
| 28 | + ([python/editorial-board#37](https://github.com/python/editorial-board/issues/37)) |
| 29 | + open for a while. |
| 30 | + * It also has a CPython issue, [python/cpython#141811](https://github.com/python/cpython/issues/141811). |
| 31 | + * A page pointing to the new locations should be left, |
| 32 | + like [this one](https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html) |
| 33 | + in the Sphinx doc. |
| 34 | + * We use [sphinxext-rediraffe](https://sphinxext-rediraffe.readthedocs.io/en/latest/) |
| 35 | + in the devguide (https://github.com/python/devguide/blob/d5ca1b4aea6281aa66ce4b25b9889e6f89c0d2fe/conf.py#L108) |
| 36 | + for redirects. |
| 37 | + * Doc redirects are currently managed by nginx: |
| 38 | + https://github.com/python/psf-salt/blob/main/salt/docs/config/nginx.docs-redirects.conf |
| 39 | + * [sphinx-reredirects](https://documatt.com/sphinx-reredirects) could be used? |
| 40 | +* [Ned] The Editorial Board is inactive lately. If people have ideas about how |
| 41 | + to evolve it, let them know. |
| 42 | +* [Stan] If anyone has time, if they could please review this little guide |
| 43 | + I wrote for merging back in translations after docs move in the devguide: |
| 44 | + [python/devguide#1700](https://github.com/python/devguide/pull/1700). |
0 commit comments