GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GH-123299: Copyedit 3.14 What's New: Use Title Case for top-level headings by AA-Turner · Pull Request #139630 · python/cpython

Conversation

@AA-Turner

@AA-Turner AA-Turner commented Oct 5, 2025 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Member
  • Issue: What's New in Python 3.14 (copyediting) #123299

📚 Documentation preview 📚: https://cpython-previews--139630.org.readthedocs.build/en/139630/whatsnew/3.14.html

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@AA-Turner
Copyedit What's New: Use Title Case for top-level headings
1f66986
@AA-Turner AA-Turner added the skip news label Oct 5, 2025
@bedevere-app bedevere-app Bot added the docs Documentation in the Doc dir label Oct 5, 2025
@github-project-automation github-project-automation Bot added this to Docs PRs Oct 5, 2025
@bedevere-app bedevere-app Bot mentioned this pull request Oct 5, 2025
What's New in Python 3.14 (copyediting) #123299
Closed
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Oct 5, 2025
hugovk
hugovk requested changes Oct 6, 2025
View reviewed changes

@hugovk hugovk left a comment

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I strongly prefer sentence case.

Our style guide says to use sentence case for headings:

In the Python documentation, the use of sentence case in section titles is preferable, but consistency within a unit is more important than following this rule. If you add a section to a chapter where most sections are in title case, you can either convert all titles to sentence case or use the dominant style in the new section title.

https://devguide.python.org/documentation/style-guide/#capitalization

Readability

I find it more readable, and it's also an accessibility thing:

Use sentence case for headings (e.g. Don't auto-play video, music and more).

  • https://www.a11yproject.com/content-style-guide/#headings

Don't write page titles in title case (with capital letters for every word). Use sentence case instead. Title case is more difficult for some people to read.

https://www.bath.ac.uk/guides/writing-accessible-web-page-titles-and-summaries/#writing-page-titles

Sentence case is easier to read.

People want to find out things quickly from your page, including whether they are on the right page. So headings need to be easy to scan and absorb.

Example

"Buying vegan cheese: what to consider" not "Buying Vegan Cheese What To Consider"

https://readabilityguidelines.co.uk/content-design/headings-titles/#4-use-sentence-case-for-headings-and-subheadings

Tech style guides

Sentence case

Google:

In document titles and headings, use sentence case. That is, capitalize only the first word in the title, the first word in a subheading after a colon, and any proper nouns or other terms that are always capitalized a certain way.

https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings

Microsoft:

Use sentence-style capitalization for headings. That means that you capitalize the first word, any proper nouns, and the first word after a colon (if there is one). Everything else is lowercase. To learn more, see Capitalization.

https://learn.microsoft.com/en-us/style-guide/scannable-content/headings#formatting-headings

Title case

Red Hat:

The standard for technical documentation is title case for all headings and titles. Table titles and procedure titles fall into this category; standard title case capitalization rules apply.

https://stylepedia.net/style/#heading-styles

Both

Apple:

Except for user interface text, guidelines for when to use sentence-style capitalization and when to use title-style capitalization are a matter of department style.

https://support.apple.com/en-gb/guide/applestyleguide/apsgb744e4a3/1.0/web/1.0#apdca93e113f1d64

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@bedevere-app

bedevere-app Bot commented Oct 6, 2025

Copy link
Copy Markdown

When you're done making the requested changes, leave the comment: I have made the requested changes; please review again.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@bedevere-app bedevere-app Bot added the awaiting changes label Oct 6, 2025
@github-actions

github-actions Bot commented Apr 30, 2026

Copy link
Copy Markdown

This PR is stale because it has been open for 30 days with no activity.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@github-actions github-actions Bot added the stale Stale PR or inactive for long period of time. label Apr 30, 2026
@hugovk hugovk closed this Apr 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@hugovk hugovk hugovk requested changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

awaiting changes docs Documentation in the Doc dir skip news stale Stale PR or inactive for long period of time.

Projects

Docs PRs
Status: Todo

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

2 participants

@AA-Turner @hugovk
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.