Skip to content

Address Smart formatting review feedback (#286): trim wording, note Melia entity gap#293

Open
petemomo wants to merge 1 commit into
mainfrom
pete/del-33629-formatting-review-followup
Open

Address Smart formatting review feedback (#286): trim wording, note Melia entity gap#293
petemomo wants to merge 1 commit into
mainfrom
pete/del-33629-formatting-review-followup

Conversation

@petemomo

@petemomo petemomo commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

What

Follow-up to the review feedback from @stuartw843 on #286 (merged).

  • Drops "with variable results" from the off-list languages note — "best-effort" already conveys the variability (addresses this comment).
  • Adds a model-support note clarifying that entity output (enable_entities, spoken_form/written_form) is available with the Standard and Enhanced models, and links to the Melia 1 feature gap in Models. This is accurate per models.mdx, which already lists "spoken form output" and "entity detection" among the features Melia 1 does not yet support.

Deferred (not in this PR)

Stuart's broader point — that under Melia the page should say smart formatting is on by default for all languages and drop enable_entities / spoken & written form entirely — is a forward-looking rewrite. It isn't accurate today: Standard and Enhanced are still the primary models (Realtime + Batch) and fully support entity output, and Melia 1 is Batch-only and early-access. That rewrite is tracked in DEL-34274, to land when Melia is the default/GA and the wording is confirmed with engineering.

Verification

  • Full docusaurus build passes with onBrokenLinks: "throw" — the new :::note compiles and the /speech-to-text/models link resolves.

- Drop "with variable results" from the off-list languages note; "best-effort"
  already conveys the variability (per review comment)
- Add a note that entity output (enable_entities, spoken_form/written_form) is
  Standard/Enhanced only, and link to the Melia 1 feature gap in Models

The larger Melia rewrite (smart formatting on by default for all languages,
removing enable_entities and spoken/written form) is deferred to DEL-34274,
pending Melia becoming the default and engineering sign-off.

DEL-33629, DEL-33895

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jul 21, 2026 3:41pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant