GeezerVison is showing github.com — Address Smart formatting review feedback (#286): trim wording, note Melia entity gap by petemomo · Pull Request #293 · speechmatics/docs
Conversation
petemomo
commented
Jul 21, 2026
•
edited
Loading
Uh oh!
There was an error while loading. Please reload this page.
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.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
- 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 <[email protected]>
vercel
Bot
commented
Jul 21, 2026
•
edited
Loading
Uh oh!
There was an error while loading. Please reload this page.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
This branch was successfully deployed
1 active
deployment
Uh oh!
There was an error while loading. Please reload this page.
Assignees
No one assigned
Milestone
No milestone
Development
Successfully merging this pull request may close these issues.
Uh oh!
There was an error while loading. Please reload this page.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.