Skip to content

Reorder initial sections on Translating page - #1894

Open
m-aciek wants to merge 1 commit into
python:mainfrom
m-aciek:reorder-translating
Open

Reorder initial sections on Translating page#1894
m-aciek wants to merge 1 commit into
python:mainfrom
m-aciek:reorder-translating

Conversation

@m-aciek

@m-aciek m-aciek commented Aug 26, 2026

Copy link
Copy Markdown
Contributor
  • Motivation section goes without a section heading first in Translating chapter,
  • Overview goes as the second,
  • and current intro text as third with Project status section heading.

In my opinion this is more natural and engaging to read for an average devguide reader.

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 CPython devguide | 🛠️ Build #34250097 | 📁 Comparing 668c374 against latest (261dc21)

  🔍 Preview build  

1 file changed
± documentation/translations/translating/index.html
@StanFromIreland

Copy link
Copy Markdown
Member

I'll have to think about this a little. Having the motivation separate was useful as it was clear what it was, and it could be linked to. Now it looks a bit like an introduction. We also hide the table, which for most people looking to translate, us probably the most important thing on the page (although I admit it was a little awkwardly placed).

@m-aciek

m-aciek commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

This table used to be a place to look for information about in-progress translations. Now that we have a dashboard, well discoverable, under own subdomain, it took (or should took) over this role. The names of coordinators and links to decisions are not critical, are more of a metadata.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants