Skip to content

[codex] fix stale user API doc links and sidebar entries#125

Merged
basit3407 merged 4 commits intomainfrom
codex/remove-stale-featured-user-sidebar-links
Apr 15, 2026
Merged

[codex] fix stale user API doc links and sidebar entries#125
basit3407 merged 4 commits intomainfrom
codex/remove-stale-featured-user-sidebar-links

Conversation

@basit3407
Copy link
Copy Markdown
Collaborator

@basit3407 basit3407 commented Apr 15, 2026

What changed

  • removed the stale featured-user sidebar entries from the shared user API sidebar helper
  • updated hardcoded manual docs links that still pointed at pre-operationId user API slugs
  • patched the committed production and pre-live OpenAPI snapshots so the generated reading-session pages link to the stable reading-sessions guide instead of a stale generated route

Why

There were two separate docs build breaks:

  • sidebars.js still injected featured-user doc IDs that are no longer generated
  • several manual and generated pages still linked to old user API slugs such as add-collection, get-all-collections, and add-update-activity-day

This PR fixes the docs repo side of both issues. A matching backend source-of-truth PR updates the reading-session description so future OpenAPI syncs do not reintroduce the stale generated link.

Validation

  • yarn clean-all
  • yarn build
@basit3407 basit3407 marked this pull request as ready for review April 15, 2026 05:44
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 15, 2026

Deploying qf-api-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: eadfd86
Status: ✅  Deploy successful!
Preview URL: https://c400450a.qf-api-docs.pages.dev
Branch Preview URL: https://codex-remove-stale-featured.qf-api-docs.pages.dev

View logs

@basit3407 basit3407 force-pushed the codex/remove-stale-featured-user-sidebar-links branch from b12f1a1 to 259582d Compare April 15, 2026 06:13
@basit3407 basit3407 changed the title [codex] remove stale featured user sidebar links Apr 15, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Fixes docs build issues caused by stale User API sidebar entries and outdated hardcoded links to User API endpoint docs.

Changes:

  • Removes injection of stale “featured users” doc IDs from the shared User API sidebar helper.
  • Updates manual MDX links to point at newer (operationId-style) User API doc slugs.
  • Updates versioned and unversioned “Reading Sessions vs Activity Days” pages’ related-links section.

Reviewed changes

Copilot reviewed 4 out of 6 changed files in this pull request and generated 3 comments.

File Description
sidebars.js Stops injecting the removed “featured users” doc IDs into the User-related APIs sidebar structure.
docs/user-related-apis/reading-sessions-vs-activity-days.mdx Updates “Related API Docs” links to new endpoint doc slugs.
docs/user-related-apis/1.0.0/reading-sessions-vs-activity-days.mdx Same link updates for v1.0.0 page.
docs/tutorials/oidc/example-integration.mdx Updates OIDC tutorial links for Collections/Bookmarks to new endpoint doc slugs.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/tutorials/oidc/example-integration.mdx
Comment thread docs/user-related-apis/reading-sessions-vs-activity-days.mdx
Comment thread docs/user-related-apis/1.0.0/reading-sessions-vs-activity-days.mdx
@basit3407 basit3407 merged commit 59ec83b into main Apr 15, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants