Skip to content

docs(live-stt): semantic end-of-turn feature page#128

Open
jqueguiner wants to merge 1 commit into
mainfrom
feat/semantic-end-of-turn
Open

docs(live-stt): semantic end-of-turn feature page#128
jqueguiner wants to merge 1 commit into
mainfrom
feat/semantic-end-of-turn

Conversation

@jqueguiner

@jqueguiner jqueguiner commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Adds a Live Transcription docs page for semantic end-of-turn, and — the main goal — explains endpointing vs end-of-turn so users know which to reach for.

What

  • New chapters/live-stt/features/end-of-turn.mdx
    • What semantic end-of-turn is (finalize when the speaker has actually finished, not just when they go quiet)
    • Endpointing vs end-of-turn: time/silence-based vs meaning-based, with a side-by-side table and a one-line summary
    • Parameter reference — threshold, emission_threshold, max_wait_secs, probe_base_ms — in user terms
    • When to use which (meetings/captioning vs voice agents/IVR)
  • endpointing.mdx: short "Endpointing vs end-of-turn" section cross-linking the two pages
  • docs.json: register the new page in the Live Transcription nav

Framing

Purely user-visible behaviour — latency, turn-taking, premature cuts on hesitation. No engine internals, no benchmark numbers (those live with the feature work, not the docs).

Pairs with the end_of_turn streaming config in the API.


Note

Low Risk
Documentation-only changes with no runtime, API, or security impact.

Overview
Adds Live Transcription documentation for semantic end-of-turn, aimed at helping users choose between silence-based endpointing and meaning-based turn finalization.

The new end-of-turn page explains the feature for voice agents and IVR, contrasts it with endpointing (including a comparison table), documents enabling via the end_of_turn live config object, and describes user-facing knobs (threshold, emission_threshold / speech_turn_end, max_wait_secs, probe_base_ms) plus guidance on when to use each approach.

endpointing.mdx gains a short Endpointing vs end-of-turn section that links to the new page, and docs.json registers the page in the Live Transcription nav after endpointing.

Reviewed by Cursor Bugbot for commit b56b2bf. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by CodeRabbit

  • New Features

    • Added documentation for semantic end-of-turn detection in Live Transcription.
    • Explained configuration options, defaults, valid ranges, and behavior.
    • Added guidance on combining end-of-turn detection with endpointing for voice agents, IVR, and live assistants.
  • Documentation

    • Added the new page to Live Transcription navigation.
    • Clarified the differences between time-based endpointing and meaning-based end-of-turn detection.

Documents the end_of_turn config for live transcription and, most of all,
explains endpointing (time/silence-based) vs semantic end-of-turn
(meaning-based) so users know which to reach for.

- new chapters/live-stt/features/end-of-turn.mdx: concept, the endpointing-vs-
  end-of-turn distinction, parameter reference (threshold, emission_threshold,
  max_wait_secs, probe_base_ms) in user terms, and when to use which
- endpointing.mdx: a short "Endpointing vs end-of-turn" section cross-linking
  the two
- docs.json: register the new page in the Live Transcription nav

Framed purely on user-visible behaviour (latency, turn-taking, premature cuts);
no engine internals.
@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2922c0ab-1b15-4d34-a4c1-72d5ac9cd991

📥 Commits

Reviewing files that changed from the base of the PR and between d252f11 and b56b2bf.

📒 Files selected for processing (3)
  • chapters/live-stt/features/end-of-turn.mdx
  • chapters/live-stt/features/endpointing.mdx
  • docs.json

📝 Walkthrough

Walkthrough

Adds a Live Transcription chapter for semantic end-of-turn detection, documents its configuration and relationship with endpointing, and includes the page in the documentation navigation.

Changes

Semantic end-of-turn documentation

Layer / File(s) Summary
Document and publish semantic end-of-turn
chapters/live-stt/features/end-of-turn.mdx, chapters/live-stt/features/endpointing.mdx, docs.json
Documents semantic end-of-turn behavior and configuration, compares it with endpointing, and adds the new chapter to Live Transcription navigation.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

  • gladiaio/docs#103: Adds the endpointing documentation page referenced by the endpointing comparison updates.

Suggested reviewers: karamouche, remilejeune2, mfernandez-gladia

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: adding a Live STT semantic end-of-turn documentation page.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/semantic-end-of-turn

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@mintlify

mintlify Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
gladia 🟢 Ready View Preview Jul 14, 2026, 3:24 PM

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

@mintlify

mintlify Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
gladia 🟡 Building Jul 14, 2026, 3:23 PM

💡 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