Skip to content

docs(v3-languages): promote to GA, deprecate v2/languages and v2/glossary-language-pairs#345

Open
daniel-jones-dev wants to merge 2 commits into
mainfrom
v3-langs/ga-phase-2
Open

docs(v3-languages): promote to GA, deprecate v2/languages and v2/glossary-language-pairs#345
daniel-jones-dev wants to merge 2 commits into
mainfrom
v3-langs/ga-phase-2

Conversation

@daniel-jones-dev
Copy link
Copy Markdown
Member

Summary

  • Promotes /v3/languages from BETA to GA: removes BETA tags, restructures nav so v3 sits at the top level and v2 endpoints become a nested DEPRECATED group.
  • Deprecates /v2/languages and /v2/glossary-language-pairs: adds Warning banners with migration links, applies tag: "DEPRECATED" on reference pages, marks endpoints deprecated: true in openapi.yaml.
  • Rewrites api-reference/languages.mdx body so it reads as a deprecated-endpoint reference instead of a live page.
  • Adds GA entry at the top of v3-languages-changelog.mdx and updates its description; drops the stale "Possible additions" / "Current beta state" sections.
  • Adds GA release entry to roadmap-and-release-notes.mdx.
  • Cleans up supported-languages.mdx: removes the stale "Text improvement languages have not yet been added" Info box now that /v3/languages?resource=write covers it.

Test plan

  • mint broken-links passes
  • mint broken-links --check-anchors passes
  • Nav renders: v3 endpoints at top level under Languages, v2 in nested DEPRECATED group
  • Deprecation Warning banners render on /v2/languages, retrieve-supported-languages, glossaries, and list-language-pairs-supported-by-glossaries
  • OpenAPI playground shows deprecated markers on v2 endpoints

🤖 Generated with Claude Code

…sary-language-pairs

- Remove BETA tags and notices from all v3/languages docs
- Rename retrieve-products.mdx to retrieve-resources.mdx
- Restructure Languages nav: v3 pages promoted to primary, v2 moved to DEPRECATED subgroup
- Add deprecated: true to GET /v2/languages and GET /v2/glossary-language-pairs in OpenAPI spec
- Add deprecation Warning to v2/languages overview and auto-generated reference page
- Add deprecation note to v2 glossaries overview for /v2/glossary-language-pairs
- Add May 5 release notes entry covering all GA changes and deprecations
- Remove v3/languages from "In active development" list

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 15, 2026

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

Project Status Preview Updated (UTC)
deepl-c950b784 🟢 Ready View Preview May 15, 2026, 5:41 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