Skip to content

chore: set up custom docs.porter.run/llms.txt - #456

Merged
adidottxt merged 6 commits into
mainfrom
adi/run-4006-chore-set-up-custom-docsporterrunllmstxt
Aug 13, 2026
Merged

chore: set up custom docs.porter.run/llms.txt#456
adidottxt merged 6 commits into
mainfrom
adi/run-4006-chore-set-up-custom-docsporterrunllmstxt

Conversation

@adidottxt

@adidottxtadidottxt commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

This PR:

  • adds a custom llms.txt that prioritizes Porter's hosted MCP server and demotes the remaining nav pages to ## Optional.
  • adds matching markdown.instructions to steer individual Markdown exports, with OAuth/headless fallback guidance.

@adidottxt
adidottxt marked this pull request as ready for review August 12, 2026 20:07
@adidottxt
adidottxt changed the base branch from adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation to mainAugust 12, 2026 20:08
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 662b016 to 3fa7200CompareAugust 12, 2026 20:09
@mintlify

mintlifyBot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
porter🟢 ReadyView PreviewAug 12, 2026, 8:09 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 3fa7200 to 60055c0CompareAugust 12, 2026 20:19
@adidottxtadidottxt changed the title chore: set up custom docs llms.txtchore: set up custom docs.porter.run/llms.txtAug 12, 2026
@adidottxt
adidottxt changed the base branch from main to adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creationAugust 12, 2026 20:24
@adidottxtadidottxt changed the title chore: set up custom docs.porter.run/llms.txtchore: set up custom docs.porter.run/llms.txtAug 12, 2026
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 60055c0 to bbb9845CompareAugust 12, 2026 20:35
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from bbb9845 to 968e47aCompareAugust 12, 2026 20:37
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 968e47a to 4415cb6CompareAugust 12, 2026 20:39
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 24c7aaf to f6eb64fCompareAugust 12, 2026 20:41
Comment threadllms.txt
Comment threadllms.txt Outdated
Comment threadllms.txt Outdated
Comment threadllms.txt
Base automatically changed from adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation to mainAugust 13, 2026 19:53
@adidottxt
adidottxtforce-pushed the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch from 9574df9 to cc2386fCompareAugust 13, 2026 20:00
Let a stated user preference override the MCP-first default in both
copies of the directive, and document create_app's source-and-build and
image modes in the MCP Server section so llms.txt covers the registry
path the page-level hints already cover.
The image argument is the container-registry path, but the text neither
said so nor linked the page. Splits the two modes by source and links
each to its guide. Drops the trailing porter.yaml sentence, which the
Agent Instructions block already covers and which read as contradicting
the stated-preference override.
The llms.txt spec treats ## Optional as skippable under context
pressure, so logging, monitoring, alerts, common errors, rollbacks, and
zero-downtime sat where an agent would drop them — the pages needed to
answer "why did my deploy fail". They move to their own section above
Optional.
The CLI keeps its position at the top of Optional per review feedback,
but only the install and basic-usage pages; the twelve command-reference
pages move to the bottom so the first thing after Core Docs is no longer
a scriptable alternative to the MCP server.
@adidottxt
adidottxt merged commit a7fa2db into mainAug 13, 2026
2 checks passed
@adidottxt
adidottxt deleted the adi/run-4006-chore-set-up-custom-docsporterrunllmstxt branch August 13, 2026 20:26
Sign up for freeto 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.

2 participants

@adidottxt@MauAraujo