Repository navigation
Having a "fast path" for documentation contributions #13
Description
This came up in the Python 3.10 release stream -- https://youtu.be/AHT2l3hcIJg?t=5700 for the exact timestamp of when this was proposed in the stream and discussed briefly -- and I noticed that no issue has been filed for this yet so... I'm doing it myself. 😅
I wasn't the person who proposed this, so... there's no bullet list items of what exactly this would be. :)
Activity
pradyunsg commentedon Oct 15, 2021
Looking at the contribution process, which took me ~10 minutes to figure out as someone familiar with where things are in the CPython codebase and Python's devguide.
main).Doc/*.rsttype-documentation.The two main things that I see can be improved:
make serveand use https://github.com/executablebooks/sphinx-autobuild/ in it. (full disclosure: I'm the primary maintainer of that)JulienPalard commentedon Oct 15, 2021
When you say « fast path » do you mean for new contributors with a good knowledge about git and rst, and using Linux, so it would look like:
?
I don't know how to properly do that, there's so many different paths, the one for those understanding git but not rst, those understanding rst but not git, those not understanding git nor rst, Windows / macOS / Linux, ..., ....
The one for those not understanding git nor rst is not a fast path though, it's a "sit down with a cup of tea 4 hour learning new things session".
What about something like:
?
pradyunsg commentedon Dec 30, 2021
Yea, that sounds about right.
It's basically a overview for folks who know roughly how the various tools works, and only need the overview + easy copy paste for figuring out how CPython does things.
This doesn't need to be a bullet list -- a doc with somewhat sequential headings like https://pip.pypa.io/en/stable/development/getting-started/ would work well, if you want to have explanation for new-comers referenced or even have them inline (headings make the page skimmable).