You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/monthly-meeting/2024-01.md
-22Lines changed: 0 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -96,28 +96,6 @@ Please take a second to read through it!
96
96
-[Ezio] It seems that for the tutorial, examples work better than prose, for both new and experienced users. Also, we could have cheatsheets for people coming from other languages.
97
97
98
98
99
-
## Follow-ups from previous meeting(s)
100
-
101
-
-[Ryan] standard library documentation reference and adding types to it in a structured way. For example, `collections.Counter.most_common` could be written
102
-
103
-
most_common(n: int) -> list[tuple[Any, int]]
104
-
105
-
[Petr] ... or `list[tuple[KeyType, int]]`?
106
-
107
-
- this has been discussed. There was opposition to adding the types to the stdlib code itself.
108
-
-[Jim] I sometimes wish for more normative, less chatty module documentation. e.g. [*heapq* module](https://docs.python.org/3/library/heapq.html). e.g. old issue 29428 [*Doctest documentation unclear about multi-line fixtures*](https://bugs.python.org/issue29428).
- Should we do this for PEPs? see [python/docs-community#22](https://github.com/python/docs-community/issues/22)
113
-
-[Hugo] See also [python/peps#3567](https://github.com/python/peps/pull/3567) for green/red sidebars for good/bad example code in PEPs
114
-
-[Jim] don't forget accessibility constraints when coming up with the style guide. e.g. some readers are red/green colourblind. ✅❌ are good in that they are legible even without colour.
115
-
116
-
-[Ryan] Thoughts about completing TOML->JSON conversion table: https://docs.python.org/3/library/tomllib.html#conversion-table and the TOML spec: https://toml.io/en/v1.0.0#spec
117
-
118
-
-[Jim] FYI, Unicode Standard is changing form of authoritative standard documents from PDF to HTML, with corresponding change to document production tooling. If this is interesting I can provide more info. I am in the working group which is working on the new tooling.
119
-
120
-
121
99
## Next meeting
122
100
123
101
The docs team generally meets on the first Tuesday of every month around 20:00-ish UTC.
0 commit comments