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-109975: Update 'What's New in Python 3.13' for beta by hugovk · Pull Request #118694 · python/cpython

Conversation

@hugovk

@hugovk hugovk commented May 7, 2024 •
edited by github-actions Bot
Loading

Uh oh!

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

Copy link
Copy Markdown
Member

Plus fix some Sphinx warnings in the NEWS changelog (there are hundreds more because we don't check them in CI).

  • Issue: What's New in Python 3.13 (copyediting) #109975

📚 Documentation preview 📚: https://cpython-previews--118694.org.readthedocs.build/

Sorry, something went wrong.

Uh oh!

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

All reactions
hugovk added 2 commits May 7, 2024 10:45
@hugovk
Update 'What's New in Python 3.13' for beta
0757590
@hugovk
Fix some Sphinx warnings in changelog
9bf5515
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir awaiting core review labels May 7, 2024
@bedevere-app bedevere-app Bot mentioned this pull request May 7, 2024
What's New in Python 3.13 (copyediting) #109975
Closed
@Yhg1s
Yhg1s merged commit 6cf7067 into python:main May 7, 2024
@bedevere-app bedevere-app Bot removed the awaiting core review label May 7, 2024
@hugovk
hugovk deleted the docs-3.13 branch May 7, 2024 10:47
JelleZijlstra
JelleZijlstra reviewed May 7, 2024
View reviewed changes
Comment thread Misc/NEWS.d/next/C API/2024-04-08-09-44-29.gh-issue-117534.54ZE_n.rst
Improve validation logic in the C implementation of :meth:`datetime.fromisoformat`
to better handle invalid years. Patch by Vlad Efanov.
Improve validation logic in the C implementation of
:meth:`datetime.datetime.fromisoformat` to better handle invalid years.

@JelleZijlstra JelleZijlstra May 7, 2024

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.

Do you know why these weren't caught on the PR adding them? Is there some configuration change we can make so that NEWS entries get linted properly by Sphinx?

Sorry, something went wrong.

Uh oh!

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

All reactions

@hugovk hugovk May 8, 2024

Copy link
Copy Markdown
Member Author

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.

We do lint them with Sphinx Lint, but that doesn't catch everything, especially not bad references.

We only check for warnings from a Sphinx build in files under Doc/:

cpython/Doc/tools/check-warnings.py

Lines 212 to 216 in c4f9823

all_rst = {
str(rst)
for rst in Path("Doc/").rglob("*.rst")
if rst.parts[1] not in EXCLUDE_SUBDIRS
}

We ignore those that are in .nitignore because they've not been "cleaned" yet, because we don't want to hassle people over warnings which they didn't introduce.

Similarly, we ignore the news files, because during the Sphinx build, they get compiled into a giant 45k line build/NEWS which has 700+ warnings (and growing, because we don't check them).

And so we don't want to warn for every single PR that adds a small NEWS blurb about those 700 warnings that they didn't introduce.

New entries are added to the top of the compiled NEWS file. One option would be to add a check to ensure the top X lines remain clean. Most NEWS entries are under 10 lines long, and the biggest right now is 18 lines, so checking something like the top 200 or so would prevent new warnings being introduced.

I started work on this in February, see hugovk#61. I'll pick this up again.

Sorry, something went wrong.

Uh oh!

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

JelleZijlstra reacted with heart emoji
All reactions
  • ❤️ 1 reaction

@hugovk hugovk May 20, 2024

Copy link
Copy Markdown
Member Author

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.

Please see PR #119221.

Sorry, something went wrong.

Uh oh!

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

All reactions
SonicField pushed a commit to SonicField/cpython that referenced this pull request May 8, 2024
@hugovk @SonicField
pythongh-109975: Update 'What's New in Python 3.13' for beta (python#…
86d6a45
…118694)
@hugovk hugovk mentioned this pull request May 20, 2024
Docs: Ensure no warnings are found in the NEWS file before a given line number #119221
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@JelleZijlstra JelleZijlstra JelleZijlstra left review comments

Uh oh!

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

Assignees

No one assigned

Labels

docs Documentation in the Doc dir

Projects

None yet

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.

3 participants

@hugovk @JelleZijlstra @Yhg1s
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.