Enrich LLM-facing documentation with context and navigation

[AvdLee]

Summary

• Adds rich <SYSTEM> headers to llms-full.txt and llms-small.txt with product context, supported platforms (iOS, macOS, watchOS, visionOS), and key capabilities
• Inserts a structured table of contents in both LLM doc variants for easier navigation
• Adds cross-reference "Related" links between related documentation pages
• Creates llms-ctx.txt with concise product context for LLM consumption
• References llms-ctx.txt from the main llms.txt entry point

Changes

• docs/src/integrations/llms-txt-post-process.ts — enhanced post-processing with SYSTEM header, TOC, cross-references, and llms.txt modification
• docs/public/llms-ctx.txt — new static file with product context

Test plan

• Verify npm run build passes
• Check generated llms-full.txt starts with rich SYSTEM header (no pricing mentioned)
• Check generated llms-full.txt has table of contents after SYSTEM header
• Check related links appear at the end of relevant pages in llms-full.txt
• Verify llms-ctx.txt is accessible at /llms-ctx.txt
• Verify llms.txt references llms-ctx.txt

[Copilot]

Pull request overview

This PR improves the generated llms-*.txt documentation artifacts by injecting richer product context, navigation helpers, and cross-page references, and adds a standalone context file (llms-ctx.txt) intended for LLM consumption.

Changes:

• Adds enriched <SYSTEM> headers, a static table of contents, and “Related” cross-links into llms-full.txt / llms-small.txt during post-processing.
• Rewrites the generated llms.txt index during build to include product info and a link to llms-ctx.txt.
• Adds a new public llms-ctx.txt file containing concise RocketSim product context and technical details.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File	Description
docs/src/integrations/llms-txt-post-process.ts	Post-processes generated LLM docs to prepend richer SYSTEM headers/TOC, append related links, and rewrite llms.txt.
docs/public/llms-ctx.txt	New static “product context” document referenced from llms.txt.

---

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

[Copilot]

TOC entry "Setting Up RocketSim Connect" uses different capitalization than the actual page title ("Setting up RocketSim Connect"). Since addRelatedLinks and other logic key off exact titles, keeping TOC/page titles consistent avoids confusion and reduces drift.

Suggested change

	- Setting Up RocketSim Connect
	- Setting up RocketSim Connect

[Copilot]

enhanceLlmsTxtIndex hard-codes the production base URL (https://www.rocketsim.app) in multiple places. Since the repo already centralizes the site URL in docs/src/config/config.json (used by docs/astro.config.ts), consider deriving the base URL from that config to avoid broken links if the domain changes or when building in non-prod environments.

[Copilot]

The "Distribution" line claims "Mac App Store + direct enterprise distribution", but the existing FAQ only states there is an out-of-the-App-Store distribution option via support contact. To avoid providing potentially incorrect product info to LLMs, consider aligning this wording with the FAQ (or linking to the official wording/source).

Suggested change

	- Distribution: Mac App Store + direct enterprise distribution
	- Distribution: Mac App Store (see official FAQ or contact support for alternative distribution options)

[Copilot]

RELATED_LINKS uses the key "Setting Up RocketSim Connect", but the actual page title in the docs frontmatter is "Setting up RocketSim Connect". Because addRelatedLinks does an exact title match, the related links block will never be added for that page. Rename the key (and any other exact-title keys) to match the real # title text.

Suggested change

	"[Setting Up RocketSim Connect](/docs/getting-started/setting-up-rocketsim-connect)",
	],
	"Setting Up RocketSim Connect": [
	"[Setting up RocketSim Connect](/docs/getting-started/setting-up-rocketsim-connect)",
	],
	"Setting up RocketSim Connect": [

[Copilot]

The TOC includes a "Testimonials" entry, but transformLlmsTxt removes the Testimonials page for the small variant. This makes llms-small.txt’s TOC point to content that won’t exist. Consider generating variant-specific TOC content (or conditionally omitting Testimonials for small).

Suggested change

- Testimonials

[Copilot]

TOC entry "Status Bar Appearance" doesn’t match the actual docs page title ("Statusbar Appearance"). Since this TOC is meant for navigation/search in the generated LLM docs, mismatched titles make it harder to correlate sections. Update the TOC text to match the real page title(s).

Suggested change

	- Status Bar Appearance
	- Statusbar Appearance

[Copilot]

TOC entry "Deep Links & Universal Links" doesn’t match the actual page title ("Deeplinks (Universal Links)"). If the TOC is intended to help locate page sections by title, keep the wording consistent with the generated # headings.

Suggested change

	- Deep Links & Universal Links
	- Deeplinks (Universal Links)

[ngnijland]

Issue:

This will be hard to maintain. We'd have to update this table of contents every time we change something in the docs (add/remove pages, change order of pages, etc). If we want this here, I think we should automate it.

[ngnijland]

Issue:

Same here. This will be hard to maintain. If we change links, add/remove pages, etc this section is outdated. We should automate this if we want this.