Skip to content

Add more languages support for disfluency#289

Open
giorgosHadji wants to merge 8 commits into
mainfrom
feature/disfluency
Open

Add more languages support for disfluency#289
giorgosHadji wants to merge 8 commits into
mainfrom
feature/disfluency

Conversation

@giorgosHadji

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Jul 13, 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 23, 2026 11:30pm

Request Review

@giorgosHadji giorgosHadji changed the title docs change for new languages support for disfleuncy docs change for new languages support for disfluency Jul 13, 2026
@giorgosHadji giorgosHadji changed the title docs change for new languages support for disfluency Add more languages support for disfluency Jul 21, 2026

@petemomo petemomo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this — and for adding the language codes, which brings the list in line with the profanities convention on the page. One ask, one question (inline), and two optional nits (inline).

The API spec still says English-only. spec/realtime.yaml (line 1130) reads "[disfluency] is only present in English", and the API reference pages are generated from that spec — merged as-is, the docs would claim both 20-language and English-only support. Since the spec lives in this repo, could you update that description in this PR? If the spec change is tracked elsewhere (e.g. it mirrors an upstream source), let me know and we'll file a follow-up instead.

Comment thread docs/speech-to-text/formatting.mdx Outdated
Comment thread docs/speech-to-text/formatting.mdx Outdated
Comment thread docs/speech-to-text/formatting.mdx Outdated

### Supported languages

Disfluency tagging and removal are available for the following languages. Each language has its own set of hesitation sounds; the full list above is for English.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: "the full list above" is a positional reference. Something like "the expandable list at the start of this section covers English" survives restructuring better.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed! Nice! changed

@giorgosHadji

Copy link
Copy Markdown
Contributor Author

Thanks for this — and for adding the language codes, which brings the list in line with the profanities convention on the page. One ask, one question (inline), and two optional nits (inline).

The API spec still says English-only. spec/realtime.yaml (line 1130) reads "[disfluency] is only present in English", and the API reference pages are generated from that spec — merged as-is, the docs would claim both 20-language and English-only support. Since the spec lives in this repo, could you update that description in this PR? If the spec change is tracked elsewhere (e.g. it mirrors an upstream source), let me know and we'll file a follow-up instead.

I have changed the spec as well here to reflect the change.
Nice catch Pete! Missed that

@petemomo petemomo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All addressed — thanks for the fast turnaround, and for going beyond the ask: catching the extra reference in voice-agent-api.mdx and making the Smart formatting heading self-contained too.

Verified locally on the updated branch:

  • No English-only disfluency claims remain anywhere in docs or spec.
  • The new #supported-languages-for-disfluencies anchor is used consistently in all three places, and nothing links to the old #languages anchor, so that rename is safe.
  • The page renders correctly with the new headings and updated in-page link.

One optional nit, take it or leave it: "Disfluency detection is supported for [supported languages]" in voice-agent-api.mdx doubles up — "available for the [supported languages]" reads smoother.

The Mandarin naming unification stays as the agreed separate task — we'll pick it up on our side. LGTM 👍

…-up) (#294)

Follow-up agreed in the #289 review (with @giorgosHadji): the docs
should use **"Mandarin"** everywhere, not "Chinese Mandarin", matching
the canonical row on the languages page (`Mandarin | cmn`).

Targeting `feature/disfluency` so it rides in with #289.

## Changes

**`docs/speech-to-text/formatting.mdx`** — the three "Chinese Mandarin"
occurrences:
- "Available Chinese Mandarin locales:" → "Available Mandarin locales:"
- Disfluency supported-languages list: "Chinese Mandarin (`cmn`)" →
"Mandarin (`cmn`)", moved to its alphabetical position (M)
- Smart formatting languages list: "Chinese Mandarin (Simplified and
Traditional)" → "Mandarin (Simplified and Traditional)", also moved to M

**`.CLAUDE/context/terminology.md`** — records "Mandarin" as the
canonical form ("Chinese Mandarin"/"Mandarin Chinese" in the do-not-use
column). This is assistant-context, not deployed site content.

## Checks
- Repo-wide grep (`docs/`, `spec/`, `src/`) — no other "Chinese
Mandarin" occurrences remain
- cspell on the changed file: 0 issues
- No headings changed, so no internal anchors break

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

Co-authored-by: Pete Mo <175202887+cabbage-ice-cream@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
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.

2 participants