Skip to content

break out product families#396

Merged
shirgoldbird merged 10 commits into
mainfrom
docs/split-product-family-tabs
Jul 13, 2026
Merged

break out product families#396
shirgoldbird merged 10 commits into
mainfrom
docs/split-product-family-tabs

Conversation

@shirgoldbird

Copy link
Copy Markdown
Member

No description provided.

shirgoldbird and others added 5 commits July 8, 2026 11:57
… fixes

- batch.py: Diataxis-aware planner that classifies content and routes to
  proper page types (never dumps narrative on openapi endpoint stubs),
  --task flag for single freeform tasks, routing/discard output fields
- promote.py: auto-add redirects when retiring pages, nested group search
  in docs.json nav (fixes spurious top-level group creation), sibling-path
  fallback for group placement
- rework.py: selective content preservation (carry unique content, skip
  spec duplicates), increased max tokens to 16384
- review.py: bumped default max iterations from 2 to 5
- run.py: --pause flag to stop after a named step for manual review
- ship.py: always create fresh branch off main, extracted shared utils
- util.py: new shared module (find_latest_run, git ops, stage/commit, PR)
- .gitignore: ignore pipeline drafts directory
…mily-tabs

# Conflicts:
#	pipeline/batch.py
#	pipeline/promote.py
#	pipeline/rework.py
#	pipeline/util.py
Real-time WebSocket streaming guide (covers: Voice) and async audio-file
translation guide (covers: Translate Audio Files), generated by the pipeline.
Placed in the Voice tab. This covers both Voice endpoint groups; detect_gaps
now reports only the Home hub link as remaining.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
deepl-c950b784 🟢 Ready View Preview Jul 9, 2026, 7:08 PM

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

- Merge the five XML & HTML pages (xml, html, structured-content,
  customized-xml-outline-detection, tag-handling-v2) into two how-to
  guides in the Translate tab: Translating XML and Translating HTML
- Move tag_handling_version reference facts (v1/v2 defaults, strict
  XML parsing, compatibility) into the API reference parameter docs
- Retire the standalone tag handling v2 guide; keep a defaults note
  on the XML guide
- Add redirects for all five old URLs and update inbound links
- Add Translate tab overview, text and document quickstarts; retire
  DeepL 101 and the translation beginner's guide

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
… split quickstarts

- Add Translate tab overview page matching the Voice/Admin pattern
- Rename the Translate quickstart to Translate Text Quickstart (text only)
- Add Translate Documents Quickstart covering the full async upload/poll/download flow
- Retire api-reference/translate.mdx and api-reference/document.mdx narrative pages;
  API Reference groups now contain only OpenAPI endpoint stubs
- Rehome unique content: model_type narrative to Understanding Model Types (explanation),
  batching/sentence-splitting/markers to Translating Large Volumes of Text (how-to),
  billing minimums/polling/glossary and format-conversion notes to the document translation guide
- Redirect retired URLs to their closest replacements and update all inbound links

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
…erviews

- Add Customize top-level tab (after Voice) with overview, Glossaries,
  Style Rules, and Translation Memories groups
- Move existing guides under docs/customize/: glossaries-in-the-real-world,
  custom-instructions, using-translation-memories (retitled), and
  customizations-for-variants (now directly under Overview)
- Retire narrative API reference pages: multilingual-glossaries, glossaries (v2),
  style-rules, and glossaries/v2-vs-v3-endpoints
- Rehome unique content: Managing Glossaries how-to (concepts, entry formats,
  PUT vs PATCH semantics, limits), Using Style Rules how-to (create, style_id,
  custom instruction management, limits), and Glossary v2 vs v3 Endpoints
  explanation (differences, mixing warnings, v2 edit workaround)
- Move deprecated list-language-pairs endpoint under the Glossaries v2 group
- Update openapi.yaml doc links to the new pages and regenerate openapi.json
- Set Customize narrative_home to own in ia.yaml, add redirects for all
  moved/retired URLs, and update inbound links across the docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
… reference nav

- Combine the v3/languages overview and common use cases pages into
  "Using the Languages API" under Home > Languages, and move the
  v2-to-v3 migration guide there too
- Remove the v3/languages changelog (GA milestones live in release notes)
  and the v2 languages overview (duplicated by its OpenAPI stub)
- Move the Write overview under the Translate tab as "Write API" and set
  Write's narrative home to Translate in ia.yaml
- API reference nav: Write endpoints as a sub-folder under Translate,
  Voice endpoints in a Real-Time sub-folder under Voice, and Languages
  split into Languages v3 / Languages v2 sub-folders
- Remove the Discord banner, update GitHub links from DeepLcom to DeepL
  (keeping the Facebook handle and composer vendor name), and add
  redirects plus inbound-link updates for all moved pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
…le/tone guide

- Add a Write group under the Translate tab with two pages, replacing the
  single Write API overview page
- Write Quickstart: rephrase, corrections-only, and writing style steps,
  with sample responses verified against the live API
- Controlling Writing Style and Tone: writing_style/tone values,
  per-language support, and prefer_ fallback behavior
- Rehome the old FAQ facts: summed Translate+Write limit to cost control,
  character_count behavior to usage limits, Write column note to the
  CSV export section
- Redirect /docs/translate/write-api and update the /api-reference/improve-text
  redirect and inbound links

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shirgoldbird shirgoldbird merged commit eace1d1 into main Jul 13, 2026
3 checks passed
@shirgoldbird shirgoldbird deleted the docs/split-product-family-tabs branch July 13, 2026 20:17
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