Move AI page to Start Here#886
Open
sirugh wants to merge 10 commits into
Open
Conversation
Signed-off-by: Stephen Rugh <rugh@adobe.com>
bdenham
added
new-topic
sirugh
commented
May 14, 2026
|
|
||
| ## How to use context files | ||
|
|
||
| Each tool below supports either the public `llms.txt` URL, pasted bundle text, or a built-in documentation index when the feature exists. |
Contributor
Author
There was a problem hiding this comment.
Add notes about how to also use AGENTS.md.
sirugh
commented
May 14, 2026
Signed-off-by: Stephen Rugh <rugh@adobe.com>
- Always enable starlight-links-validator; exclude only generated llms paths - Remove SKIP_LINK_VALIDATION from PR and Pages workflows - Pages preview: run generate:llms before build; keep Supabase env for build step - build-with-ai: use production Link URLs for bundle table Co-authored-by: Cursor <cursoragent@cursor.com>
Match base-prefixed paths (for example GitHub Pages) so generated llms bundles are excluded from internal route checks. Co-authored-by: Cursor <cursoragent@cursor.com>
Drop scripts/REVERT-LLMS-DEPLOY-BASE.md; keep STOREFRONT-LLMS-DEPLOY-BASE grep marker in script and workflow. Co-authored-by: Cursor <cursoragent@cursor.com>
sirugh
commented
May 15, 2026
| # STOREFRONT-LLMS-DEPLOY-BASE — env for scripts/generate-llms-full.js public doc URL (grep repo to revert). | ||
| - name: Build with Astro | ||
| id: build | ||
| run: NODE_ENV=github VITE_GITHUB_BASE_PATH=${{ steps.pages.outputs.base_path }} SKIP_LINK_VALIDATION=true pnpm astro build \ |
Contributor
Author
There was a problem hiding this comment.
What's the change here?
| - name: Build | ||
| run: pnpm run build:prod | ||
| env: | ||
| SKIP_LINK_VALIDATION: 'true' # PR branches are incomplete by design |
Contributor
Author
There was a problem hiding this comment.
What did this mean and why is it being removed in the context of this PR?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose of this pull request
This pull request relocates the AI documentation bundles topic from Resources into Get started, renames it to match what the page actually covers (Documentation bundles for AI tools), and rewrites the content for clearer beginner orientation: audience and outcome in the opening, concrete Cursor steps (including the
llms.txtURL and a settings-search fallback), a Claude Code success check, trimmed non-duplicative tips (boilerplate alignment and optional page URL pastes), and redirects so old URLs keep working.Associated JIRA ticket
COMDOX-1672
Affected pages
/resources/build-with-ai/and/build-with-ai/redirect to the Get started URL)whatsnew
The storefront docs site now generates (with every build) llms text bundles for consumption by various AI tools and models. These bundles help developers ask questions in their editor's chat windows to get up-to-date docs information while they are building their storefronts.