Skip to content

improvement(docs): reduce navigation payload and build work - #9285

Merged
waleedlatif1 merged 5 commits into
stagingfrom
codex/docs-performance
Oct 21, 2026
Merged

waleedlatif1 merged 5 commits into
stagingfrom
codex/docs-performance

Conversation

@waleedlatif1

@waleedlatif1 waleedlatif1 commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Render only expanded sidebar branches and load authored page bodies asynchronously.
  • Fetch Markdown when Copy page is clicked instead of embedding the full text in every page payload, preserving clipboard activation and retry feedback.
  • Disable unused production browser source maps. Keep navigation, API-language, and clipboard regression checks in CI without adding visitor telemetry.

Type of Change

  • Performance improvement

Testing

All CI checks passed, including the docs production build, HTTP/content negotiation checks, and all 10 desktop/mobile browser cases. Browser checks cover navigation, every API request language, and Markdown clipboard success, failure, retry, and client navigation; CI uploads screenshots and a JSON report. The Vercel preview deployment succeeded and was checked in the browser.

Scoped Biome, diff checks, and Fumadocs source generation also passed. No heavy local build or test suite was run.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing (new tests pass the test-audit authoring gate)
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

@waleedlatif1
waleedlatif1 requested a review from a team as a code owner October 21, 2026 17:38
@vercel

vercel Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 21, 2026 6:36pm UTC

Request Review

@greptile-apps

greptile-apps Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable new issues were found.

Summary

This PR reduces docs navigation and page payloads.

  • Authored documentation pages load their content when it is needed.
  • Copy page fetches Markdown only after someone clicks it.
  • Closed sidebar branches keep their nested links unmounted.
  • Production docs builds no longer emit browser source maps.
  • Docs CI checks navigation, API tabs, and Markdown copying in a browser.

The latest changes load sitemap dates from async page data and guard browsers without AbortSignal.timeout. No actionable new issues were found. Builds and browser checks were not run during this review.

Reviews (4) · Last reviewed commit: "fix(docs): preserve sitemap dates with l..." · Reviewed by Greptile

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 9 files

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Turn on auto-fix | Re-trigger cubic

Comment thread apps/docs/scripts/generate-llms-full.ts Outdated
Comment thread apps/docs/scripts/measure-performance.ts Outdated
@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No issues found across 11 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Turn on auto-fix | Re-trigger cubic

@waleedlatif1 waleedlatif1 changed the title improvement(docs): reduce build work and instrument performance improvement(docs): reduce navigation payload and build work Oct 21, 2026
@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 11 files

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Turn on auto-fix | Re-trigger cubic

Comment thread apps/docs/source.config.ts
Comment thread apps/docs/components/page-actions.tsx Outdated
@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

1 issue found across 12 files

Confidence score: 5/5

  • apps/docs/app/sitemap.ts loads each page sequentially, which can slow sitemap generation. Use Promise.all to load pages concurrently.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. When an issue isn't valid or won't be fixed in this PR, reply in its thread with the reason and then resolve the thread. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/docs/app/sitemap.ts">

<violation number="1" location="apps/docs/app/sitemap.ts:12">
P3: The loop awaits each page's `load()` in series, so sitemap generation waits on every MDX body one after another. Collect the promises and await them together with `Promise.all` so the loads run concurrently.</violation>
</file>

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Turn on auto-fix | Re-trigger cubic

Comment thread apps/docs/app/sitemap.ts
@waleedlatif1
waleedlatif1 merged commit 5e4339f into staging Oct 21, 2026
60 checks passed
@waleedlatif1
waleedlatif1 deleted the codex/docs-performance branch October 21, 2026 18:42

This branch was successfully deployed

1 active deployment
Preview — 2b576bda Deployed Oct 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant