chore: make agent path more prominent in app creation docs - #454
Merged
adidottxt merged 9 commits intoAug 13, 2026
Merged
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
adidottxt
force-pushed
the
adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation
branch
from
August 12, 2026 16:39
f2b0896 to
229ae4e
Compare
Contributor
Author
|
Superseding the earlier Context7-pending note: the strict before/after evaluation now passes without relying on Context7 as the primary harness.
That is a 53.8% reduction in context before the agent path appears. All six agent-only visibility checks pass. The three-trial Claude outcome gate also passes: 18/18 preview answers lead with Context7 is retained as an optional site-wide spot check; the reproducible primary gate fetches and hashes production/preview |
adidottxt
force-pushed
the
adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation
branch
2 times, most recently
from
August 12, 2026 17:53
409bf5d to
4178b8d
Compare
adidottxt
force-pushed
the
adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation
branch
from
August 12, 2026 17:54
4178b8d to
bbb3edb
Compare
adidottxt
marked this pull request as ready for review
August 12, 2026 18:07
adidottxt
changed the title
MauAraujo
approved these changes
Aug 13, 2026
Address review feedback that the Agent tab opened directly on a heading while the Dashboard and CLI tabs open with a lead-in sentence. Adds a one-line description and converts the three sections to <Steps>.
Address review feedback that the agent hints should not push an agent toward create_app when the user has asked for something else. Each <Visibility for="agents"> block now leads with the exception — dashboard, CLI, porter apply, or configuration-as-code — before stating create_app as the default, and says not to author a porter.yaml otherwise.
Agents fetching the registry page had no create_app guidance. Points them at the image argument, and notes that it needs no pull request and no GitHub App, unlike the source-and-build flow.
adidottxt
deleted the
adi/run-4007-chore-make-the-agent-path-more-prominent-in-the-app-creation
branch
August 13, 2026 19:53
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.
This PR updates our docs to prioritize the agent path for Porter's hosted MCP server and its
create_apptool for creating an application.This is done in a few ways:
snippets/agent-create-app.mdx) to the quickstart and GitHub deploy pages. Agent is first and default (the tab states the Porter GitHub App prerequisite), and also gives a copy-pasteable prompt, and explains the merge-the-PR step.applications/deploy/connect-github, linked from both the Agent and Dashboard paths.applications/deploy/overviewto concepts and adds reciprocal links from the MCP docs.<Visibility for="agents">, so.md/llms.txtexports steer agents tocreate_app.I also setup some evals in #455: agent guidance in the top two results went from 1/4 to 4/4 generic queries, median tokens before agent guidance dropped 53.8%, and 18/18 Claude trial answers lead with
create_app(+13 over production).