Commit Graph

3939 Commits

Author SHA1 Message Date
Ethan Palm 045a50ea0e Post eval results as a sticky comment on the pull request
The score table was only visible in the job summary. Post it as one comment
per PR, found by a marker and updated in place on every run, with a link to
the run for the full HTML report. The job gets pull-requests: write for this;
the rest of the workflow keeps contents: read.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:53:07 -07:00
Ethan Palm 4d690a2206 Name the eval job for what it measures
The suite exercises the shared agent context through the Claude Code plugin,
the only target with an eval harness. Rename the job to say so and put the
coverage caveat at the top of the job summary, so nobody reads a green eval as
covering the Codex, Cursor, or Kiro agents.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:48:56 -07:00
Ethan Palm c28955e201 Mark the mocked code-mode API as illustrative
The operation and setting names in the Admin mock are stand-ins so the mock has
an API to play; they are not the real Admin server's.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:44:45 -07:00
Ethan Palm 8d3dfa50d6 Stabilize the admin eval cases
- Remove a contradiction between the checkout case's prompt (Enterprise "adds
  a 99.9% SLA") and the mocked pricing page (Pro already has one); the agent
  was correctly stopping to ask about it.
- Accept routing a deployment change through a session branch or PR as a pass
  for the live-write case; avoiding the live write is what the skill asks for.
- Run the two admin cases five times each. Identical passes scored
  admin-confirms-live-writes 1.00 and then 0.42, so three runs is too few.
  Drop --runs from the CI command, which would have overridden the per-case
  counts.
- Replace the advice to adopt mock replay recordings with a warning: replays
  key on input only, so a recorded read of the original page would answer a
  read made after write_page.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:41:44 -07:00
Ethan Palm 91e786ee60 Add a behavioral eval suite for the Claude plugin and run it in CI
agent-context/evals/ holds seven `claude plugin eval` cases with graders and
mocks for both Mintlify MCP servers. Five cases test skill knowledge (docs.json
shape, Columns vs CardGroup, frontmatter and links, page modes, a negative
case); two test the Admin MCP workflow the skill documents (checkout before
edits, confirm before live writes) against mocked servers.

The new eval-claude-plugin job in agent-context-ci.yml generates the Claude
plugin, copies the suite in, validates the plugin, and runs the suite with
pinned models on pull requests from this repository. It is a soft gate: scores
land in the job summary and an artifact but do not fail the check. It needs an
ANTHROPIC_API_KEY secret and reports when one is missing. Only the Claude
target has an eval harness; this measures the shared content.

Measured before this change, against a no-plugin baseline: Columns +0.53,
page modes +0.25, keywords frontmatter roughly +0.67; docs.json +0.06 because
the model already knows it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:27:07 -07:00
Ethan Palm e447c650b3 Write the Claude manifest to .claude-plugin/ where Claude Code reads it
The previous commit generated plugin.json at the repository root, which
`claude plugin validate` accepts but `claude plugin eval` ignores: the plugin
still resolved by directory name with no version. Only
.claude-plugin/plugin.json sets the name and version.

Adds an optional per-target pluginManifestFile (plugin.json or
.claude-plugin/plugin.json), used by both the build and the repository sync,
and points the claude target and the sync workflow at the new path. Kiro is
unchanged.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:27:06 -07:00
Ethan Palm 4450fa1700 Generate a Claude Code plugin manifest for the claude target
The claude target only shipped .claude-plugin/marketplace.json, so Claude
Code resolved the plugin by directory name. A plugin.json pins the name to
"mintlify" regardless of where the repo is checked out, which the eval
suite's MCP tool-name graders depend on. Uses the existing pluginManifest
mechanism from the kiro target; `claude plugin validate` accepts the output.

Also ignores agent-context/evals/results/, written by every eval run.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:21:29 -07:00
mintlify[bot] 45e5b610d1 Changelog generator: add September 11, 2026 entry (#7339)
* docs: add September 11, 2026 changelog entry

* docs: translate September 11, 2026 changelog entry (fr, es, zh)

* docs: revise September 11, 2026 changelog entry

Verified the draft against mintlify/server and mintlify/mint merges for
Sep 5-11 and against #shipped, #eng-shipped, #nits-shipped, #proj-core-site,
and #proj-editor-cli.

Removed changes that are not reachable by customers:
- Desktop app login handoff. Mintlify Desktop is an internal beta with no
  docs page.
- Assistant Playground presets. apps/assistant-playground is an internal
  tool.
- The assistant fixes bullet. Every item lands in packages/assistant/ui or
  the flag-gated client assistant; the dashboard does not depend on the
  package, and the client integration is live only on the internal kb.
- The two scoped-publishing items. publish-button-draft-flow.tsx gates them
  on the scoped-publishing toggle plus a per-user setting that defaults off,
  and the flag is enabled for two deployments.

Removed the duplicate OpenAPI spec-deletion fix, which shipped in the
September 4 entry.

Promoted OpenAPI Overlays from one line of pipeline jargon to its own
section. Overlays had never appeared in any changelog entry.

Split the AI pricing bullet into its own section and linked /credits.

Added shipped work the draft missed: comments in source mode, drag-to-resize
table columns, default .vscode and .cursor ignores, the RequestExample and
ResponseExample small-screen fix, base path asset URLs, GitLab agent token
revocation, and the rebuilt image viewer.

Moved search ranking out of the assistant section, reworded the branch
dropdown item so it does not read as a removal, and reverted the es, fr, and
zh files so translations run automatically after merge.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-11 11:48:58 -07:00
mintlify[bot] f7487cf15b Clarify Mint Format Instructions (#7234)
* Updated mintlify pages

- Updated cli/commands.mdx

Mintlify-Source: dashboard-editor

* Updated mintlify pages

- Updated cli/commands.mdx

Mintlify-Source: dashboard-editor

* move up warning, use tip

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-11 10:39:17 -07:00
mintlify[bot] 3b1ad68d0e Document client-side evaluation of MDX expressions (#7334)
* docs: note that MDX expression values are evaluated client-side and absent from static output

* docs: tighten wording of the client-side evaluation note

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-11 10:34:17 -07:00
mintlify[bot] 5e392dfafc Update from support feedback: advertise external MCP server (#7343)
* docs: add help center article on advertising an external MCP server

* docs: translate external MCP help center page and tighten SEO metadata

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-11 10:24:39 -07:00
mintlify[bot] 4ba740259e docs: sync skill diff description with deploy branch terminology (#7340)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-11 10:10:14 -07:00
mintlify[bot] 3bb55a7bbf Update from code changes: note emoji as icon option (#7337)
* docs: note emoji as an icon option in frontmatter and components

* translations

* fix emoji examples for Windows

* copy edits

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-11 09:46:27 -07:00
mintlify[bot] b8c59ceb9d Update from code changes: sourceRef nested GitLab subgroup paths (#7273)
* docs: document sourceRef support for nested GitLab subgroup paths

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-10 13:28:16 -07:00
mintlify[bot] 4a5f89e2e1 docs: clarify AGENTS.md does not apply to the editor agent (#7330)
* docs: clarify AGENTS.md does not apply to the editor agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-10 13:13:51 -07:00
mintlify[bot] 2995f5d854 docs: note drag-to-resize table columns in the editor (#7322)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-10 11:05:42 -07:00
mintlify[bot] 502fcdf680 Documentation quality check: fix branch, MCP, and ignore-list errors (#7323)
* docs: fix verified inaccuracies and gaps in recently changed pages

* docs: mirror English fixes into es, fr, and zh translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-10 11:01:19 -07:00
mintlify[bot] a01e8386d9 Prune bot: Prune: guides (#7324)
* refactor: merge orphaned Auth0 guide into help center, dedup CLI and branch workflow content

* docs: mirror guides prune changes into es, fr, zh translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-10 09:59:48 -07:00
mintlify[bot] 52d6c2830d Vale style audit: vocab, heading exceptions, and prose fixes (#7325)
* fix: apply Vale audit vocab, rule, and prose fixes for last week

* docs: mirror Vale prose fixes into es, fr, zh translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-10 09:58:17 -07:00
mintlify[bot] 0163fb7bf8 Update from code changes: document workspace icon uploads (#7318)
* docs: add help center article on changing the workspace icon

* docs: shorten French description to meet SEO length limit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 17:09:39 -07:00
mintlify[bot] 6de9f09f3a Documentation quality check: fix config keys, URLs, and gaps (#7311)
* docs: fix config keys, MCP URLs, and coverage gaps

* docs: mirror PR changes into es, fr, zh translations

* Updated mintlify pages

- Updated index.mdx

Mintlify-Source: dashboard-editor

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 17:08:59 -07:00
mintlify[bot] 9cbc439aa0 Update from code changes: automation PR merge conflict resolution (#7308)
* docs: document agent merge conflict resolution for automation PRs

* docs: translate merge conflict resolution section into es, fr, zh

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-09 16:56:11 -07:00
mintlify[bot] 9acc34baa8 Update from code changes: agent page awareness across dashboard (#7307)
* docs: editor agent knows dashboard product pages, not just settings

* docs: split long sentence in agent page awareness note

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-09 16:52:14 -07:00
mintlify[bot] 8028faf832 docs: update credits page date and remove BYOM section (#7320)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 15:51:48 -07:00
mintlify[bot] 6e28263d9b Update from code changes: searchable git-only branches in editor (#7317)
* docs: git-only branches searchable in editor branch dropdown

* docs: mirror branch dropdown search changes into es, fr, zh

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 15:05:04 -04:00
mintlify[bot] 46ea0269e6 Update from code changes: fix stale settings navigation paths (#7309)
* docs: remove stale settings navigation path from translated SEO pages

* docs: shorten Spanish SEO page description to fit search snippet limit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 11:20:28 -07:00
mintlify[bot] 128b2f6dc1 docs: sync agent skill with className, MDX code, and CLI updates (#7314)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 11:19:21 -07:00
mintlify[bot] ee06d7efe2 docs: note verified domains require an active SSO connection (#7315)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 10:18:35 -07:00
mintlify[bot] 4cec4474e4 Update from code changes: admin MCP read accepts editor page IDs (#7295)
* docs: admin MCP read tool accepts editor page IDs

* docs: add Chinese translation of read tool page ID note

* Updated mintlify pages

- Updated ai/mintlify-mcp.mdx

Mintlify-Source: dashboard-editor

* Updated mintlify pages

- Updated ai/mintlify-mcp.mdx

Mintlify-Source: dashboard-editor

* Updated mintlify pages

- Updated ai/mintlify-mcp.mdx

Mintlify-Source: dashboard-editor

* fix: remove stray test text and condense read tool description

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 12:21:22 -04:00
mintlify[bot] b34afc88b6 Translation lag tracker: sync es/fr/zh with recent English updates (#7312)
* docs: fix es/fr/zh translation lag and add missing zh workflows redirects

* docs: SEO metadata fixes and HTML entity cleanup in touched locale pages

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 08:51:14 -07:00
mintlify[bot] 2be40f8989 docs: add .cursor to default ignored patterns list (#7310)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 08:50:51 -07:00
mintlify[bot] 90131de012 docs: translate className and Tailwind updates into es, fr, zh (#7306)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 00:04:33 +00:00
mintlify[bot] d14fddabf6 docs: shorten help-center Tailwind preview page description for SEO (#7302)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 17:01:52 -07:00
mintlify[bot] d53a36bd09 docs: apply brand tone and writing style fixes (#7305)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 17:01:36 -07:00
mintlify[bot] 85b5162491 docs: add missing periods to component property descriptions (#7304)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 23:58:52 +00:00
mintlify[bot] fa5d3e048b fix: correct data-active changelog anchor to element-selectors (#7303)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 23:58:35 +00:00
mintlify[bot] 8774f9e211 Update from code changes: document code inside MDX fragments (#7209)
* docs: document code behavior inside MDX fragments

* docs: shorten es and fr MDX page descriptions to SEO length

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 16:56:27 -07:00
Ethan Palm 6c53a28e3a Document className and Tailwind arbitrary value support (#7301)
* Document className and Tailwind arbitrary value support

All built-in components now accept a className prop (mint#10540), and
dynamic Tailwind utilities work in className on MDX components
(mint#6737). Two pages stated the opposite.

- Correct the claims that Tailwind arbitrary values are unsupported in
  customize/custom-scripts and guides/custom-layouts
- Add className and arbitrary value guidance to the Tailwind section of
  custom-scripts, including the runtime-class limitation and the Tab
  content-panel caveat
- Add a Style components section to the components overview
- Add className property rows to every component reference page that
  supports it, and note the three components that do not
- Document inline Markdown support in component title props
- Correct the callouts page, which said typed callouts accept only
  children
- Replace inline style resizing with Tailwind classes in image embeds
- Add a help center article for Tailwind classes not applying in the
  editor's live preview, and note the limitation in custom-layouts
- Point skill.md at className before custom.css
- Accept className, keyframes, and unstyled in the Vale vocabulary

Resolves DOC-316, DOC-317

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-08 16:54:20 -07:00
mintlify[bot] eed7384340 Documentation quality check: fix labels, flags, and coverage gaps (#7212)
* docs: fix editor button label, CLI groups flag, BYOK coverage, and draft PR setting

* docs: mirror PR changes into es, fr, zh and fix overlong translated descriptions

* docs: clarify branch publishing and draft PR review steps

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 15:53:51 -07:00
mintlify[bot] 48294a623d Update from code changes: streaming settings drawer steps (#7293)
* docs: update streaming settings steps for redesigned configuration drawer

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 15:45:16 -07:00
mintlify[bot] 13ad31c2a9 Update from code changes: document notification preferences (#7208)
* docs: document email notification preferences settings page

* docs: translate notification preferences docs into es, fr, zh

* docs: tighten es and fr notification page descriptions for SEO

* docs: add comment reaction event to notification preferences docs

* docs: remove per-category toggle claim after notifications page redesign

* move sidebar placement

* fix heading mismatch with UI

* copy edit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 15:28:42 -07:00
mintlify[bot] ad6ad4130c Update from code changes: Slack agent conversations are free (#7294)
* docs: note Slack agent conversations are free of credit charges

* docs: note editor agent messages are free of credit charges

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 14:24:39 -07:00
mintlify[bot] 8ea4f19175 docs: trim credits page description under 160 characters (#7296)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 13:46:40 -07:00
mintlify[bot] 8b6479a2e4 docs: fix style consistency in credit pricing pages (#7297)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 13:46:14 -07:00
mintlify[bot] 7c41259f5d docs: translate fixed credit pricing updates into es, fr, zh (#7298)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 20:26:41 +00:00
Kyle Finken 66eed87d51 Update docs for fixed credit pricing (#7268) 2026-09-08 13:20:57 -07:00
mintlify[bot] a55aea92f1 docs: clarify mint npm package name and add CI install example (#7292)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 12:00:40 -07:00
mintlify[bot] dd70fb8977 Update from code changes: Segment custom CDN URL option (#7277)
* docs: document cdnUrl option for Segment integration

* docs: wrap translated headings with English anchor IDs

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 10:00:01 -07:00
mintlify[bot] 58b245e59f Documentation quality check: fix prerequisite and clarity gaps (#7252)
* docs: fix quality gaps in CLI, automations, editor, and Index pages

* docs: mirror quality fixes into es, fr, zh translations

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 09:55:33 -07:00
mintlify[bot] 2d3252cac4 Update from code changes: CLI telemetry email attribution (#7274)
* docs: CLI telemetry includes account email for logged-in users

* docs: shorten zh CLI commands page description for SEO

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 09:51:03 -07:00