Skip to content

Documentation quality check: fill gaps in recently updated pages#6685

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/c8bb19d2
Open

Documentation quality check: fill gaps in recently updated pages#6685
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/c8bb19d2

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Two-phase reader-question evaluation of English MDX files updated in the last 24 hours; content additions close the most impactful answerability gaps.

Changes

agent/index.mdx

  • Gap: Page described the agent's capabilities but never told readers where to send prompts (Slack, dashboard, or automations).
  • Fix: Added a "How to use the agent" section near the top with the three entry points and links to /agent/slack and /automations/index.

components/tree.mdx

  • Gap: Both authoring syntaxes were shown without guidance on when to prefer one; Tree.File props table listed only name with no indication it was exhaustive.
  • Fix: Added a one-sentence "when to use which" note under the intro, and stated explicitly that Tree.File accepts only the name prop.

create/text.mdx

  • Gap: The anchor-ID generation rules (updated in Feedback on anchor ID generation #6658) were described in prose without any worked examples, so readers had to guess what a heading would slugify to.
  • Fix: Added an examples table mapping heading text to generated ID, covering apostrophes, periods, parentheses, slashes, ampersands, casing, and the duplicate -2 suffix.

dashboard/audit-logs.mdx

  • Gap: Streaming setup asked for AWS credentials and a Datadog site value without saying which IAM permissions the S3 user needs or which Datadog site strings map to which region.
  • Fix: Added a "Prepare credentials" AccordionGroup with a minimum-viable S3 IAM policy example and the list of Datadog site values by region. Also normalized the CSV export step numbering (1./1./1.1./2./3./4.).

guides/claude-code.mdx

  • Gap: No way for a reader to confirm Claude Code was correctly wired to CLAUDE.md and the Mintlify skill/MCP before starting to prompt.
  • Fix: Added a verification sentence after the skill/MCP prompt describing an expected first check and what a working response looks like.

guides/codex.mdx

  • Gap: MCP setup showed the config.toml snippet but didn't say to create the file if missing, didn't mention restarting the session, and didn't clarify how the persistent MCP setup relates to the in-session skill/MCP prompt shown earlier.
  • Fix: Added file-creation note, restart-and-verify step, and one paragraph distinguishing persistent (config.toml) vs. per-session prompt loading.

Context

Triggered by the scheduled documentation quality check for pages changed between 2026-07-20 and 2026-07-21.


Note

Low Risk
Documentation-only MDX edits across English and localized pages; no application code, auth, or data-handling changes.

Overview
This PR fills answerability gaps in English MDX and mirrors the same additions in es, fr, and zh locales.

Agent — Adds a How to use the agent section listing Slack, dashboard, and automations as prompt entry points.

Tree — Adds guidance on when to use Markdown list vs component syntax, and notes that Tree.File only accepts name.

Format text — Adds a heading text → generated anchor ID examples table (apostrophes, punctuation, duplicates, etc.).

Audit logs — Adds accordion Prepare credentials for S3 IAM (s3:PutObject) and Datadog site values; fixes CSV export step numbering.

Claude Code / Codex guides — Adds setup verification prompts and Codex MCP notes (create config.toml, restart session, persistent vs in-session loading).

Reviewed by Cursor Bugbot for commit 56fede9. Bugbot is set up for automated code reviews on this repo. Configure here.

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 21, 2026, 10:13 AM

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

@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 21, 2026, 10:13 AM

@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟡 Building Jul 21, 2026, 10:11 AM

@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟡 Building Jul 21, 2026, 10:11 AM

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

Sign up for free to 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.

1 participant