Skip to content

gh-103484: Remove the outdated generator tutorials footnote in unittest.mock examples - #162166

Merged
StanFromIreland merged 3 commits into
python:mainfrom
farisbasha:docs-dabeaz-tutorial-links
Nov 18, 2026
Merged

StanFromIreland merged 3 commits into
python:mainfrom
farisbasha:docs-dabeaz-tutorial-links

Conversation

@farisbasha

Copy link
Copy Markdown
Contributor

The two footnote links in the unittest.mock examples page
(Doc/library/unittest.mock-examples.rst) point at
http://www.dabeaz.com/coroutines/index.html and
http://www.dabeaz.com/generators/. Both now return 404.

David Beazley moved these tutorials to his tutorials page, where each one has
its own anchor. This PR links to those two entries:

Both anchors exist on the live page. The old URLs return 404 when fetched,
and there are no other copies of them in the repository.

The dead links were found and the change was prepared with help from an AI
assistant (Claude).

The coroutines/index.html and generators/ pages on dabeaz.com now
return 404. Link to the matching entries on the tutorials page instead.
@python-cla-bot

python-cla-bot Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

Comment thread Doc/library/unittest.mock-examples.rst Outdated
@@ -672,10 +672,11 @@ To configure the values returned from the iteration (implicit in the call to
[1, 2, 3]

.. [#] There are also generator expressions and more `advanced uses

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think we can drop the footnote, this isn't the place for this. Additionally, I tried to review the materials (since they target 2.5), but they are behind some form of wall (which probably isn't ideal for readers).

@farisbasha farisbasha changed the title gh-103484: Fix dead links to David Beazley's generator tutorials gh-103484: Remove the outdated generator tutorials footnote in unittest.mock examples Nov 18, 2026
@farisbasha

Copy link
Copy Markdown
Contributor Author

Thanks, agreed. I've dropped the footnote (and its reference marker) instead of updating the links, and retitled the PR to match.

@read-the-docs-community

read-the-docs-community Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #35978815 | 📁 Comparing bc8ab91 against main (c7fef83)

  🔍 Preview build  

4 files changed
± library/os.html
± library/unittest.mock-examples.html
± using/windows.html
± whatsnew/changelog.html

@StanFromIreland StanFromIreland added needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes labels Nov 18, 2026
@StanFromIreland
StanFromIreland merged commit f5ec90d into python:main Nov 18, 2026
39 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Nov 18, 2026
@miss-islington-app

Copy link
Copy Markdown

Thanks @farisbasha for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14, 3.15.
🐍🍒⛏🤖

@bedevere-app

bedevere-app Bot commented Nov 18, 2026

Copy link
Copy Markdown

GH-162200 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 bugs and security fixes label Nov 18, 2026
@bedevere-app

bedevere-app Bot commented Nov 18, 2026

Copy link
Copy Markdown

GH-162201 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Nov 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants