Skip to content

Conversation

@freakboy3742
Copy link
Member

In the recent documentation reorg, we missed a couple of places where the old documentation project pages were referenced in surfaced content:

  • The project links on the homepage right sidebar pointed at /docs/toga and /docs/briefcase
  • Redirects for /briefcase and /project/briefcase pointed to /docs/briefcase (similar for toga, podium, and Python-Apple-support)
  • Old references to pages under the project tree were updated to point at a docs equivalent
  • The /docs/briefcase project page contained a reference to beeware.readthedocs.io as the tutorial

The last one was reported as #718.

Ultimately, in the current content layout, the old "project" pages (like /docs/briefcase) should no longer exist. However, we can't completely remove them because so much of the page layout depends on having a database of "projects" to iterate over. This set of changes retains the project pages, but removes any links to them so they are at least hard to find; and if they are found, they'll point at correct content.

/me puts another notch in the "we need to get rid of lector" post...

Fixes #718

PR Checklist:

  • All new features have been tested
  • All new features have been documented
  • I have read the CONTRIBUTING.md file
  • I will abide by the code of conduct

@freakboy3742 freakboy3742 requested a review from kattni November 24, 2025 23:06
@freakboy3742 freakboy3742 added the preview Approved for an automated preview label Nov 24, 2025
@github-actions
Copy link

github-actions bot commented Nov 24, 2025

Visit the preview URL for this PR (updated for commit 6c6428b):

https://beeware-org--pr719-project-links-ozvjbor8.web.app

(expires Mon, 01 Dec 2025 23:39:11 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: b0da44bc067e7d9a4255c77cb2c5fce572218cec

@freakboy3742 freakboy3742 added preview Approved for an automated preview and removed preview Approved for an automated preview labels Nov 24, 2025
@freakboy3742
Copy link
Member Author

URLs to test:

Homepage

Shortlinks

Top level URL shortcuts

Historical project pages

Really historical project pages (project/projects/...)

Docs pages (...that shouldn't exist, but have to for reasons)

Historical references to current projects in docs pages

Copy link
Contributor

@kattni kattni left a comment

Choose a reason for hiding this comment

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

Verified links above. Looks good to me. Thanks for doing this.

@kattni kattni merged commit 78d7b54 into beeware:lektor Nov 25, 2025
2 checks passed
@freakboy3742 freakboy3742 deleted the project-links branch November 25, 2025 00:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

preview Approved for an automated preview

Projects

None yet

Development

Successfully merging this pull request may close these issues.

https://beeware.readthedocs.io/ throws 404

2 participants