Reorganise the devguide to directories

[AA-Turner]

From the discord discussion, this is an attempt to add some structure to Docs/Tests/Triage and clean up the top level.

No content has been edited, except for combing two duplicated "how to become a triager" sections. As I moved content between pages I had to edit the underlines -- I also standardised some ^ underlines and out-of-order underlines to allow easier page moves in the future (e.g. a core-dev folder, buildbots, language design and change).

cc: @ezio-melotti @encukou @CAM-Gerlach

Preview: https://cpython-devguide--895.org.readthedocs.build/

A

[hugovk]

Currently there is a bent towards joinedupwords, but garbage_collector, c-api, and gh-(faq|labels) are exceptions. I'd suggest preferring some form of spacing character for filenames of more than two words, and potentially for filenames of two words.

Let's use a hyphen, because you can use alt+arrow key (on Mac, ctrl+arrow on Windows?) to jump between words. Underscore is treated as a letter.

[CAM-Gerlach]

Implemented all your other changes (I went with a slightly different title for a few files).

Thanks so much, much appreciated! 🎉

What filenames would you suggest?

This is what I would suggest, following the discussion above (you could add ref aliases for the new names, but leave the existing ones obv). The main intent is to more helpfully describe the document's contents, clearly disambiguate it from others and ensure it is a good match for the document title, to aid navigating to/linking the correct one in the source.

Filename suggestions here

Core dev:

• committing -> accepting-prs
• coredev -> becoming-coredev
• developers -> developer-log

Development workflow:

• communication -> communication-channels
• devcycle -> dev-cycle
• extensions -> extension-modules
• langchanges -> lang-changes
• stdlibchanges -> stdlib (to parallel extensions)

CPython's internels:

• garbage_collector -> garbage-collector

Getting Started:

• fixingissues -> fixing-issues
• gitbootcamp -> git-bootcamp
• help -> getting-help
• pullrequest -> pull-request-lifecycle
• setup -> setup-building

Testing:

• buildworker -> setup-new-buildbot
• runtests -> run-write-tests
• silencewarnings -> silence-warnings

Triaging:

• tracker -> issue-tracker
• triageteam -> triage-team

Currently there is a bent towards joinedupwords, but garbage_collector, c-api, and gh-(faq|labels) are exceptions. I'd suggest preferring some form of spacing character for filenames of more than two words, and potentially for filenames of two words.

Definitely agreed (was going to go with -), that's a significant part of what I was thinking as it greatly improves readability.

Let's use a hyphen, because you can use alt+arrow key (on Mac, ctrl+arrow on Windows?) to jump between words. Underscore is treated as a letter.

My plans as well 👍

[AA-Turner]

Clearly I messed something up when pushing after doing the filter-repo steps, I thought I'd rebased on upstream properly to retain the history. GitHub won't let me re-open the PR, so opening a new one.

A