|
| 1 | +--- |
| 2 | +author:["Mariatta"] |
| 3 | +title:"Meeting Minutes: Mar 11, 2025" |
| 4 | +date:"2025-03-11T14:11:49-07:00" |
| 5 | +description:"Meeting Minutes from Python Docs Editorial Board: Mar 11, 2025" |
| 6 | +summary:"Meeting Minutes from Python Docs Editorial Board: Mar 11, 2025" |
| 7 | +tags:["minutes"] |
| 8 | +categories:["minutes"] |
| 9 | +series:["Meeting Minutes"] |
| 10 | +ShowToc:false |
| 11 | +TocOpen:false |
| 12 | +members:["Carol Willing", "Guido van Rossum", "Joanna Jablonski", "Mariatta", "Ned Batchelder"] |
| 13 | +--- |
| 14 | + |
| 15 | +###Agenda |
| 16 | + |
| 17 | +*[Docs audit with Savanna](https://docs.google.com/document/d/10MSDlxmgPex3ZGVr-4OggI2lqSAlv_0OTDchGlrLIkk/edit?usp=sharing) is on hold while she deals with other commitments |
| 18 | +*[https://github.com/python/editorial-board/issues/25](https://github.com/python/editorial-board/issues/25) (translation management) (issue is closed) |
| 19 | + |
| 20 | +###Notes |
| 21 | + |
| 22 | +* Wiki: |
| 23 | +* Carol went to Docs WG meeting last week. Discussion about the wiki. It is outside of EB’s focus. But we should not link to the wiki from Python docs. |
| 24 | +* It would be great to have an Educational Landing page -> for a Python user, it would be better to have it instead of the wiki.python. |
| 25 | +* Wiki is not a PSF-owned infrastructure? |
| 26 | +* We have many links (~20) to the wiki from cpython repo. Most were old what’s new docs. |
| 27 | +* We will update and unlink (?) |
| 28 | +* Maybe write in Devguide about the status about wiki.p.o. It is a community-run resource, it has implied authority beyond its actual authority. |
| 29 | +* Translations is doing well, now there is a translations dashboardhttps://python-docs-translations.github.io/dashboard/ |
| 30 | +* Issue 25 is now closed, opened a Discourse instead[https://discuss.python.org/t/pep-545-update-pep/83534/](https://discuss.python.org/t/pep-545-update-pep/83534/) |
| 31 | +* There is now typing.python.org |
| 32 | +* Why is it separate from docs.python.org? |
| 33 | +* It’s maintained by typing council. |
| 34 | +* A set of standards for type checkers (which are not maintained by Python core) |
| 35 | +* Should we explain all the different (something).python.org -> specifically wiki and typing |
| 36 | +* Add writeup in devguide about which ones are Core Python docs, and there are things like packaging. |
| 37 | +* Should we add typing.python.org as “not in scope” in our charter doc? |
| 38 | +* The typing.p.o docs aren't tied to CPython version |
| 39 | +* Carol received comment from a Linux conference attendee, last few Python releases have been easy to install. |
| 40 | +* Ned is still going on with Devguide reorg (Initially we set a due date to get it done by PyCon US - PyCon US is in 2 months) |
| 41 | +* “Or” vs “|” in the docs. |
| 42 | +* Feb 11 notes: prefer | instead of “or”. We should write it to our changelog[https://github.com/python/editorial-board/blob/main/CHANGELOG.md](https://github.com/python/editorial-board/blob/main/CHANGELOG.md) |
| 43 | +*[https://github.com/python/editorial-board/issues/7](https://github.com/python/editorial-board/issues/7) |
| 44 | +* It depends on the Sphinx’ capability. It is supported in latest Sphinx and docs are now built using latest Sphinx. |
| 45 | +* Need to go back in our notes and backfill the Changelog.md file |
| 46 | +* The Docs WG are to ask the PSF to pay for the translation tools. |
| 47 | + |