Skip to content

Add translation audit tracker#5055

Merged
ethanpalm merged 30 commits intomainfrom
mintlify/translation-audit-1775056542
Apr 2, 2026
Merged

Add translation audit tracker#5055
ethanpalm merged 30 commits intomainfrom
mintlify/translation-audit-1775056542

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 1, 2026

Summary

Comprehensive audit comparing English MDX files against their es/, fr/, and zh/ translations using git history to identify pages that genuinely need translation work.

Findings

  • 4 missing pages (API analytics endpoints) need full translation in all 3 languages
  • 3 pages with content changes need translator attention: agent/workflows.mdx (new disable/enable section), ai/skillmd.mdx (agent-skills discovery endpoint + generation time note), editor/publish.mdx (AI-generated PR titles tip)
  • 150 pages need their description: frontmatter field translated after the SEO description improvement commit
  • 14 pages were excluded because their English-only changes were style fixes (Vale warnings, tense corrections, punctuation) that don't affect translations

Methodology

Each candidate file was inspected at the commit level. Changes were classified as needing translation only if they contained new or changed prose, headings, UI labels, or structured content. English-only style fixes (future-to-present tense, Vale vocabulary swaps, punctuation) were excluded.


Note

Low Risk
Low risk documentation-only changes: mostly frontmatter description copy updates plus a few new/expanded sections, with no runtime or config logic changes.

Overview
Updates Spanish and French docs copy at scale, primarily expanding/translating frontmatter description fields for SEO/clarity across many pages.

Adds/expands a few user-facing docs sections, including workflow disable/enable guidance in agent/workflows.mdx, richer MCP server docs describing the new Search + Get page tools and updated rate limits, a note that skill.md generation can take up to 24 hours, and an editor publishing tip about AI-generated PR titles/descriptions.

Introduces new localized API reference pages for analytics export endpoints (feedback/by-page, searches, views, visitors) in es/api/analytics/* and fr/api/analytics/*.

Written by Cursor Bugbot for commit 4455935. This will update automatically on new commits. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 1, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 1, 2026, 3:21 PM

Phase 1: Add translations for 4 new API analytics pages (feedback-by-page,
searches, views, visitors) in es, fr, and zh.

Phase 2: Update 3 pages with content changes:
- agent/workflows: add "Disable a workflow" subsection
- ai/skillmd: add 24-hour generation note
- editor/publish: add AI PR title tip, reformat publishing workflows,
  promote "Publish your changes" heading from h3 to h2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Update the description: frontmatter field across 150 pages × 3 languages
to match the current English descriptions updated on 2026-03-31.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ethanpalm ethanpalm merged commit fbdd913 into main Apr 2, 2026
5 checks passed
@ethanpalm ethanpalm deleted the mintlify/translation-audit-1775056542 branch April 2, 2026 17:53
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