Restructure index page

[StanFromIreland]

This moves a few sections around to been more introductory rather than jumping straight into the quickstart, drops less important/relevant sections to the bottom (i.e. the alternative implementations), removes the version section stub (it has been there for long enough), and updates a few little things along the way.

[read-the-docs-community]

Documentation build overview

📚 CPython devguide | 🛠️ Build #31672440 | 📁 Comparing ebb4907 against latest (50dd71b)

🔍 Preview build

Show files changed (25 files in total): 📝 24 modified | ➕ 0 added | ➖ 1 deleted

File	Status
index.html	📝 modified
contrib/index.html	📝 modified
core-team/index.html	📝 modified
documentation/index.html	📝 modified
genindex/index.html	📝 modified
getting-started/index.html	📝 modified
versions/index.html	📝 modified
contrib/core-team/index.html	📝 modified
core-team/committing/index.html	📝 modified
core-team/experts/index.html	📝 modified
developer-workflow/development-cycle/index.html	📝 modified
developer-workflow/psrt/index.html	📝 modified
documentation/markup/index.html	📝 modified
documentation/start-documenting/index.html	📝 modified
getting-started/pull-request-lifecycle/index.html	📝 modified
getting-started/setup-building/index.html	📝 modified
include/activate-tab/index.html	➖ deleted
triage/labels/index.html	📝 modified
triage/triaging/index.html	📝 modified
contrib/core-team/committing/index.html	📝 modified
contrib/core-team/experts/index.html	📝 modified
contrib/triage/labels/index.html	📝 modified
contrib/triage/triaging/index.html	📝 modified
contrib/workflows/compile/index.html	📝 modified
documentation/translations/coordinating/index.html	📝 modified

[nedbat]

A few tweaks to existing sentences, but I like it!

[encukou]

Are we OK with the security implications of recommending this for every contributor's machine?
cc @sethmlarson

[sethmlarson]

We're currently using tags as rev for our config, so that would allow any compromised pre-commit repo to instantly execute code by rewriting the tag on a repo. To mitigate this we could adopt using git commit SHAs instead of git tags in the rev field, I believe that pre-commit supports this use-case?

It's obviously an extra support burden to upgrade and maintain these, but it removes the risk of a single compromise to a repository elsewhere from allowing RCE on all contributor machines.

[hugovk]

To mitigate this we could adopt using git commit SHAs instead of git tags in the rev field, I believe that pre-commit supports this use-case?

Yes, by using --freeze with either of these commands:

prek autoupdate --freeze
pre-commit autoupdate --freeze

[StanFromIreland]

I'll remove it from here for now, and open an issue when this is merged.

[hugovk]

Freezing the hooks in python/cpython#140682.

[encukou]

This is a “soft redirect” for people who have #status-of-python-branches bookmarked. Can we keep it?

[hugovk]

I think ~4 years is long enough.

Thinking of the old flow:

• Click my bookmark
• Taken to https://devguide.python.org/#status-of-python-branches
• Click "Moved to Status of Python versions"
• Taken to https://devguide.python.org/versions/#versions

If someone has still been going through all that rigmarole for 4 years and hasn't updated their bookmarks, I think removing this is a good prompt.

[StanFromIreland]

I agree with Hugo, I'll remove it unless you feel strongly about keeping it.

We could add a redirect, but it would be quite messy, as such I don't think its worth it.

[hugovk]

I think ~4 years is long enough.

Thinking of the old flow:

• Click my bookmark
• Taken to https://devguide.python.org/#status-of-python-branches
• Click "Moved to Status of Python versions"
• Taken to https://devguide.python.org/versions/#versions

If someone has still been going through all that rigmarole for 4 years and hasn't updated their bookmarks, I think removing this is a good prompt.

[encukou]

Thank you!