Skip to content

Commit 346e443

Browse files
authored
Add Oct 2024 notes (#22)
1 parent c0470c8 commit 346e443

File tree

1 file changed

+70
-0
lines changed

1 file changed

+70
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
author: ["Mariatta"]
3+
title: "Meeting Minutes: Oct 14, 2024"
4+
date: "2024-10-14"
5+
description: "Meeting Minutes from Python Docs Editorial Board: October 14, 2024"
6+
summary: "Meeting Minutes from Python Docs Editorial Board: October 14, 2024"
7+
tags: ["minutes"]
8+
categories: ["minutes"]
9+
series: ["Meeting Minutes"]
10+
ShowToc: false
11+
TocOpen: false
12+
members: ["Carol Willing", "Guido van Rossum", "Mariatta", "Ned Batchelder"]
13+
---
14+
15+
### Agenda
16+
17+
* Contribution Guide progress
18+
* Modernizing Python Docs
19+
20+
### Notes
21+
22+
23+
* Contribution Guide progress
24+
* PR created, approved.
25+
* PR build: [https://cpython-devguide--1426.org.readthedocs.build/](https://cpython-devguide--1426.org.readthedocs.build/)
26+
* PR: [https://github.com/python/devguide/pull/1426](https://github.com/python/devguide/pull/1426)
27+
* Status:
28+
* There is a new section within the current Devguide: “(draft)” item on the left menu.
29+
* How do we feel about it landing on main right now?
30+
* Worried about people ending up in the draft accidentally and thought it’s the real one.
31+
* There is an info box at the top of each contrib guide saying it’s a WIP.
32+
* Example: [https://cpython-devguide--1426.org.readthedocs.build/contrib/intro/](https://cpython-devguide--1426.org.readthedocs.build/contrib/intro/) there is a box at the top.
33+
* [Ned TODO] Add the plan of this new contrib guide under “Introduction”
34+
* [Ned TODO] embolden the section head in side bar also.
35+
* How can people discover this?
36+
* [devguide.python.org/contrib](devguide.python.org/contrib)
37+
* Or look for the menu item
38+
* Concerns with merging
39+
* Linking concerns?
40+
* Plan: flesh out the pages that don’t exist first. Then move things around later?
41+
* We use Sphinx include directives.
42+
* Make sure existing devguide maintainers and docs wg community take one last look
43+
* Hugo, Jelle, Ezio, Petr
44+
* DevGuide landing page, has a Quick Reference. It goes straight to code contribution. Feedback from people: it’s not relevant to doc contribution. Need a better pathway.
45+
* Move the Quick reference to the code contribution.
46+
* On the landing page there is the table for contribution paths, we can move that up.
47+
* Instead of table with many rows, it could be a table with two rows and bullet lists.
48+
* We could use tabs too?
49+
* What’s the next steps after merging?
50+
* Ned will write up the plan
51+
* Talk to people mentioned above
52+
* Merge the PR
53+
* More todo items from above
54+
* Get feedback from people interested in writing sections and see it grow
55+
* Do people want to be “codeowners” on the new contrib guide?
56+
* Maybe eventually
57+
58+
* Modernizing Python Docs (Mariatta)
59+
* Inspiration [https://docs.astro.build](https://docs.astro.build)
60+
* tutorials.python.org built with new content and new tech
61+
* What is the vision?
62+
* Guido would like to see a smaller project using this new/other technology.
63+
* We can frame it as “PDEB wants to try things out and will solicit feedback from the community.”
64+
* Maybe take existing tutorials/how to and see how it works on this new tech.
65+
* See also [https://mystmd.org/](https://mystmd.org/)
66+
* Alternative tech that has JS interactivity
67+
* Start with a small prototype of a tutorial
68+
* Slice tutorial?
69+
70+

0 commit comments

Comments
 (0)