Update docs/monthly-meeting/2024-01.md #97
Conversation
|
@gvanrossum and Carol, I paraphrased a lot of your words for the notes. Would you mind grepping for your name to check I got the gist right? |
There was a problem hiding this comment.
Fixed some typos and Carolified some willingc.
How much rephrasing and additions are we allowed to do here? I think I could reorganize my thoughts in a more structured way and possibly add more details, but it seems the meeting minutes are supposed to match what was said a bit more closely.
Is there any other place that would be more appropriate to summarize/capture some of the things that have been discussed in various Discord/Discuss threads and meetings?
Co-authored-by: Ezio Melotti <[email protected]>
|
|
||
| - If we have time, would like to hear from Daniele on the [thread he started on the structure of the Python docs](https://discuss.python.org/t/diataxis-and-python-documentation/41836) as to the takeways from that so far and next steps there. | ||
|
|
||
| - Discussion between Daniele and Ezio on the Python tutorial |
There was a problem hiding this comment.
Should we add more context here @ezio-melotti @evildmp?
There was a problem hiding this comment.
We could add the summary of the Discord thread where the discussion started.
Co-authored-by: Ege Akman <[email protected]>
discuss.python.org is the best place. Any significant change should be discussed there, rather than only on Docs Discord or meetings. |
docs/monthly-meeting/2024-01.md
Outdated
|
|
||
| - [Petr] The `tkinter`, `pty`/`termios`, `sqlite3` (maybe more?) use `master/slave` terminology in API and docs. What's the best way to come up with, and switch to, better terms? Is there an expert I should talk to? | ||
| - [Carol] Thursday Bram has authored a Responsible Communications book which may have helpful guidelines. Other communities have used `leader/follower`. [Linux PR on the subject](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=49decddd39e5f6132ccd7d9fdc3d7c470b0061bb) | ||
| - [Hugo] Some suggestions: https://www.ietf.org/archive/id/draft-knodel-terminology-14.html#name-master-slave (Carol: I like the suggestions in this document for different usages.) |
There was a problem hiding this comment.
Please turn this into a clickable link.
There was a problem hiding this comment.
which part of the text exactly ?
There was a problem hiding this comment.
The URL:
https://www.ietf.org/archive/id/draft-knodel-terminology-14.html#name-master-slave
There was a problem hiding this comment.
Aren't links automatically clickable in MD?
See e.g. https://www.ietf.org/archive/id/draft-knodel-terminology-14.html#name-master-slave, with no special markup.
There was a problem hiding this comment.
This one wasn't clickable when I originally checked the preview.
There was a problem hiding this comment.
See also the hackmd link at the top.
Co-authored-by: Ned Batchelder <[email protected]>
Co-authored-by: Ezio Melotti <[email protected]>
|
Thank you! |
📚 Documentation preview 📚: https://docs-community--97.org.readthedocs.build/en/97/