@@ -47,12 +47,12 @@ to read through it!
4747> beginning of the meeting.
4848
4949- Python Docs Editorial Board has meeting minutes published at
50- https://python.github.io/editorial-board/
50+ < https://python.github.io/editorial-board/ >
5151
5252## Discussion
5353
5454- [ Ned] Reorganization of the devguide --> Contributor's Guide:
55- https://github.com/python/devguide/pull/1426
55+ [ python/devguide # 1426 ] ( https://github.com/python/devguide/pull/1426 )
5656
5757 - this grew out of a recognition that we want to recognize other types of
5858 contributions than “dev”.
@@ -105,9 +105,9 @@ to read through it!
105105 tutorials, so we wanted one official place with up-to-date info. We went with a
106106 separate repo, so we could use a different tech stack. We went with a plain theme,
107107 but there are so many themes now, even ones for Sphinx.
108- - For https://numpy.org/numpy-tutorials/ we went with a separate repo, with a
108+ - For < https://numpy.org/numpy-tutorials/ > we went with a separate repo, with a
109109 different technical setup (jupytext - text-based notebooks)
110- https://github.com/numpy/numpy-tutorials
110+ < https://github.com/numpy/numpy-tutorials >
111111 - [ Mariatta] It's great knowing that NumPy went through this path, now we need to do
112112 it for Python. I feel that we don't need Sphinx for tutorials.
113113 - [ Trey] Maybe if we don't make it as fancy as astro.build, but get 80% there, it'll
@@ -124,21 +124,21 @@ to read through it!
124124 see a page that's technical and dense, they get scared. It'll be easier on them if
125125 we make them transition to information-dense docs. "Pretty and friendly" is more
126126 important.
127- - [ Mariatta] I've also used https://docusaurus.io/ Which is a JavaScript approach.
127+ - [ Mariatta] I've also used < https://docusaurus.io/ > Which is a JavaScript approach.
128128 But in the end I like astro best.
129129 - [ Carol] in the past, the biggest change would be Markdown vs. ReST. From
130130 experience with other projects, Markdown lets you have the flexibility to change
131131 tooling if needed, so the display is separate from the content.
132132 - [ Carol] Were there concerns at the sprint?
133133 - [ Melissa] What Mariatta showed made me thing of learning paths:
134- https://en.wikipedia.org/wiki/Learning_pathway -- people can start where they
134+ < https://en.wikipedia.org/wiki/Learning_pathway > -- people can start where they
135135 need, depending on how much handholding they need etc.
136136 - [ Mariatta] Maybe the first quiz should be “what kind of a learner are you”?
137137 - [ Carol] Moving away from the tooling: I thing there's a subset of users that use
138138 the current Python tutorial, others use different ones - Carpentries, ones from
139139 the scientific ecosystem, Dr.Chuck, Chicago[ ???] , etc. The Carpentries have done a
140140 great job in the past decade coming up with learning-theory-based tutorials:
141- https://carpentries.org/community-lessons/
141+ < https://carpentries.org/community-lessons/ >
142142 - [ Mariatta] So what do we do next?
143143 - [ Carol] 2 steps: talk about it as EB, but also reach out to Tania & the community
144144 success project, so there's no duplication of effort. In an ideal world, this
0 commit comments