From 07bf91444646753622002c445ea43746fb5a76fd Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Thu, 3 Sep 2026 11:56:43 +0200 Subject: [PATCH 1/2] Use row-first flex layout for documentation index --- Doc/tools/templates/indexcontent.html | 144 ++++++++++++-------------- 1 file changed, 64 insertions(+), 80 deletions(-) diff --git a/Doc/tools/templates/indexcontent.html b/Doc/tools/templates/indexcontent.html index 59a693c00003c45..602b46cc35f7c6d 100644 --- a/Doc/tools/templates/indexcontent.html +++ b/Doc/tools/templates/indexcontent.html @@ -16,17 +16,17 @@ @@ -50,84 +50,68 @@

{{ docstitle|e }}

{% trans %}Welcome! This is the official documentation for Python {{ release }}.{% endtrans %}

{% trans %}Documentation sections:{% endtrans %}

-
-
+ {% trans %}Standard library modules{% endtrans %} +
  • {% trans %}Language reference{% endtrans %}
    + {% trans %}Syntax and language elements{% endtrans %}
    • +
  • {% trans %}Python setup and usage{% endtrans %}
    + {% trans %}How to install, configure, and use Python{% endtrans %}
    • +
  • {% trans %}Python HOWTOs{% endtrans %}
    + {% trans %}In-depth topic manuals{% endtrans %}
    • +
  • {% trans %}Installing Python modules{% endtrans %}
    + {% trans %}Third-party modules and PyPI.org{% endtrans %}
    • +
  • {% trans %}Extending and embedding{% endtrans %}
    + {% trans %}For C/C++ programmers{% endtrans %}
    • +
  • {% trans %}Python's C API{% endtrans %}
    + {% trans %}C API reference{% endtrans %}
    • +
  • {% trans %}FAQs{% endtrans %}
    + {% trans %}Frequently asked questions (with answers!){% endtrans %}
    • +
  • {% trans %}Deprecations{% endtrans %}
    + {% trans %}Deprecated functionality{% endtrans %}
    • +

    {% trans %}Other resources:{% endtrans %}

    -
    - - -
    +

    {% trans %}Indices, glossary, and search:{% endtrans %}

    -
    - - -
    +

    {% trans %}Project information:{% endtrans %}

    -
    - - -
    + {% endblock %} From 40eaa33484db9170a321b7ab9d856f03a1d32313 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Mon, 14 Sep 2026 22:54:05 +0200 Subject: [PATCH 2/2] Align documentation contents with homepage section order --- Doc/contents.rst | 12 ++++++------ Doc/tools/templates/indexcontent.html | 8 ++++---- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/Doc/contents.rst b/Doc/contents.rst index 852be4a6d5b6ba7..40f9c090e3d00b6 100644 --- a/Doc/contents.rst +++ b/Doc/contents.rst @@ -6,19 +6,19 @@ whatsnew/index.rst tutorial/index.rst - using/index.rst - reference/index.rst builtins/index.rst library/index.rst + reference/index.rst + howto/index.rst + using/index.rst + installing/index.rst extending/index.rst c-api/index.rst - installing/index.rst - howto/index.rst faq/index.rst deprecations/index.rst glossary.rst - about.rst bugs.rst - copyright.rst license.rst + copyright.rst + about.rst diff --git a/Doc/tools/templates/indexcontent.html b/Doc/tools/templates/indexcontent.html index 602b46cc35f7c6d..dc2a95fc021b029 100644 --- a/Doc/tools/templates/indexcontent.html +++ b/Doc/tools/templates/indexcontent.html @@ -56,15 +56,15 @@

    {{ docstitle|e }}

  • {% trans %}Tutorial{% endtrans %}
    {% trans %}Start here: a tour of Python's syntax and features{% endtrans %}
  • {% trans %}Built-ins reference{% endtrans %}
    - {% trans %}Built-in functions and classes{% endtrans %}
    • -
  • {% trans %}Library reference{% endtrans %}
    + {% trans %}Built-in functions and classes{% endtrans %}
    • +
  • {% trans %}Library reference{% endtrans %}
    {% trans %}Standard library modules{% endtrans %}
  • {% trans %}Language reference{% endtrans %}
    {% trans %}Syntax and language elements{% endtrans %}
    • -
  • {% trans %}Python setup and usage{% endtrans %}
    - {% trans %}How to install, configure, and use Python{% endtrans %}
  • {% trans %}Python HOWTOs{% endtrans %}
    {% trans %}In-depth topic manuals{% endtrans %}
    • +
  • {% trans %}Python setup and usage{% endtrans %}
    + {% trans %}How to install, configure, and use Python{% endtrans %}
  • {% trans %}Installing Python modules{% endtrans %}
    {% trans %}Third-party modules and PyPI.org{% endtrans %}
  • {% trans %}Extending and embedding{% endtrans %}