Skip to content

Update from code changes: document mint deslop command#6644

Open
mintlify[bot] wants to merge 4 commits into
mainfrom
mintlify/99ed5a6d
Open

Update from code changes: document mint deslop command#6644
mintlify[bot] wants to merge 4 commits into
mainfrom
mintlify/99ed5a6d

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new mint deslop CLI command and its Admin API counterpart, which check documentation pages for AI-sounding prose and return humanization suggestions.

Changes

  • Added a mint deslop section to cli/commands.mdx covering the arguments, flags (--subdomain, --format, --threshold, --fix-whitespace), default file selection, exit-code behavior, examples, whitespace normalizer, and JSON output shape.
  • Added POST /v1/deslop/{projectId} to admin-openapi.json with the request body, scored and skipped response shapes, and error responses (400, 402, 429, 503).
  • Added a new api/deslop/check.mdx page under a new Deslop group in the API reference navigation, with a credits note and a curl example.
  • Cross-linked the CLI section to the Admin API endpoint.
  • Mirrored all new content and navigation entries into Spanish (es/), French (fr/), and Chinese (zh/).

Context

Documents:

  • mintlify/mint#9046 — mint deslop [files..] CLI command with --threshold, --format table|plain|json, --fix-whitespace, and JSON output for agent loops.
  • mintlify/server#6593 — POST /api/cli/deslop (CLI) and POST /api/external/v1/deslop/:projectId (Admin API) backed by Pangram detection and OpenRouter rewrite suggestions; each scored page charges 1 AI credit and pages under 50 words are settled as a free skip.

Update history

  • Initial: Added the mint deslop CLI reference section in English (documents mintlify/mint#9046).
  • Follow-up: Translated the mint deslop CLI section into Spanish, French, and Chinese.
  • Follow-up: Documented the Admin API endpoint POST /v1/deslop/{projectId} — added the OpenAPI operation, a new api/deslop/check page under a new Deslop navigation group, translations, and a cross-link from the CLI section (documents mintlify/server#6593).

Note

Low Risk
Documentation and OpenAPI/navigation updates only; no application or API implementation changes in this repo.

Overview
Documents deslop—AI-sounding prose detection for MDX/Markdown—across the CLI reference, Admin OpenAPI spec, and API reference navigation.

Adds a mint deslop section to cli/commands.mdx (flags, default git-changed file selection, threshold/exit behavior, --fix-whitespace, JSON output) and links it to the HTTP API. Introduces POST /v1/deslop/{projectId} in admin-openapi.json with request/response schemas, credit rules (1 AI credit per scored page; free skip under 50 words), and 400/402/429/503 errors. Adds api/deslop/check under a new Deslop nav group in docs.json, plus mirrored OpenAPI, MDX, CLI, and nav entries for es, fr, and zh.

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

@mintlify

mintlify Bot commented Jul 17, 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 17, 2026, 11:29 PM

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 17, 2026, 11:30 PM

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

@mintlify

mintlify Bot commented Jul 17, 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 17, 2026, 11:27 PM

@mintlify

mintlify Bot commented Jul 17, 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 17, 2026, 11:27 PM

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

@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Translated the new deslop Admin API endpoint into Spanish, French, and Chinese

Source PRs

  • mintlify/server#6593 — feat(cli): deslop route — Pangram AI-slop detection with humanization suggestions

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