Title: Feature: move the "quick reference" from the devguide root to a dedicated page under Getting Started · Issue #1837 · python/devguide · GitHub
Open Graph Title: Feature: move the "quick reference" from the devguide root to a dedicated page under Getting Started · Issue #1837 · python/devguide
X Title: Feature: move the "quick reference" from the devguide root to a dedicated page under Getting Started · Issue #1837 · python/devguide
Description: Describe the enhancement or feature you would like As the root page has evolved, it has become more clearly an index page, with some high level content but not much detailed documentation, leaving that for other pages. Technical guidance...
Open Graph Description: Describe the enhancement or feature you would like As the root page has evolved, it has become more clearly an index page, with some high level content but not much detailed documentation, leaving ...
X Description: Describe the enhancement or feature you would like As the root page has evolved, it has become more clearly an index page, with some high level content but not much detailed documentation, leaving ...
Opengraph URL: https://github.com/python/devguide/issues/1837
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature: move the \"quick reference\" from the devguide root to a dedicated page under Getting Started","articleBody":"### Describe the enhancement or feature you would like\n\nAs the root page has evolved, it has become more clearly an index page, with some high level content but not much detailed documentation, leaving that for other pages. Technical guidance at the level of \"run this command\" no longer belongs at the root of the docs, except perhaps in summary fashion.\n\nI think we should add a new page to the Getting Started docs, but *after* \"Setup and building\" in doc order. The intention being that this is explicitly *not* a \"quickstart guide\", and treating it as such should be subtly discouraged.\n\n### Describe alternatives you have considered\n\nInitially, I intended to propose we remove the section. The content it covers *is* fully captured by other pages.\nHowever, the \"quick reference\" is, itself, unusual in that it spans the concerns of cloning, building, testing, running `blurb`, and opening a PR. For a new contributor, who may have done only 1-2 PRs already, having an easy reference doc which fits on one page, especially as reminders for those final steps, is useful.\n\nI also weighed the possibility of subtly changing the purpose of the doc, from \"Quick Reference\" to \"Quickstart\". There are two reasons I rejected the idea. First, the target audience for this doc is not, in my opinion, brand new contributors. It's for newer or infrequent contributors who benefit from having an easy reference to things they've already learned. The second reason is that the typical implication of a \"quickstart\" guide is that \"you follow these steps and you'll be ready\", which seems like the wrong message to send to new contributors.\n\n### Additional context\n\nThis was inspired out of a discord conversation ([ref](https://discord.com/channels/935215565872693329/935219976481161216/1515465671733940338)). @nedbat noted that [the \"quick reference\" section](https://devguide.python.org/#quick-reference) in the index doc is not well-placed. I agree, and think there are a couple of options for what to do.\n\nAt first, I thought it was _just_ a git reference doc, and intended to propose removal. Looking closely, I think there is a useful thing here worth preserving. I had never -- as a new contributor -- looked at this bit of doc, and there are subtle details in it which are good reminders! e.g.,\n```bash\n./python -m test -j3\n```\nreminds me that I can pass `-j \u003cN>` to the testsuite.","author":{"url":"https://github.com/sirosen","@type":"Person","name":"sirosen"},"datePublished":"2026-06-13T22:38:56Z","url":"https://github.com/python/devguide/issues/1837"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:f3d01826-a8cf-3d0b-0422-dceb6be5e671 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D290:29AEE8:3550CFD:46FD74F:6B020211 |
| html-safe-nonce | 98aa3607eca05c8ec78b27769bb6fc9db944a6af29e00ea9e712430addcabd35 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMjkwOjI5QUVFODozNTUwQ0ZEOjQ2RkQ3NEY6NkIwMjAyMTEiLCJ2aXNpdG9yX2lkIjoiODcwNjc4MTMxNzk3NjY4NzEyMSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 6ac0cf6d2f426d2fe6766ae2c548cf74e7737a9bab0ed04030eae147bacbc08e |
| hovercard-subject-tag | issue:4657175204 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/devguide/1837/issue_layout |
| twitter:image | https://opengraph.githubassets.com/6419062b0b043aa534c2be53ee248348a2768a445ff30a09afbb90f7fcc06a26/python/devguide/issues/1837 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/6419062b0b043aa534c2be53ee248348a2768a445ff30a09afbb90f7fcc06a26/python/devguide/issues/1837 |
| og:image:alt | Describe the enhancement or feature you would like As the root page has evolved, it has become more clearly an index page, with some high level content but not much detailed documentation, leaving ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | sirosen |
| hostname | github.com |
| expected-hostname | github.com |
| None | 87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/devguide git https://github.com/python/devguide.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 63972479 |
| octolytics-dimension-repository_nwo | python/devguide |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 63972479 |
| octolytics-dimension-repository_network_root_nwo | python/devguide |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 423dbb54c5e7bfecc838eb387c1435eb3d0e760d |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width