Repository navigation
Remove legacy frontmatter, placeholder defaults, and duplicated text from AI reference pages - #873
Merged
Merged
Conversation
…ages Remove legacy id/unlisted/hide_title frontmatter from the languages, prompt, and Google Cloud TTS pages; drop default="None" on four languages[] ParamFields the source gives no default; cut the duplicated filler resolution order on the prompt page and the repeated function_fillers text on the multilingual page; move the voice-language guide to ## headings in sentence case, retitle it without &, and use # for Python comments. Refs #598
Contributor
Manny-r31
reviewed
Oct 28, 2026
Manny-r31
left a comment
Collaborator
There was a problem hiding this comment.
Review: ready to merge
CI is green, no conflicts. Nothing blocking.
Verified
- Removing
default="None"is correct:ai_languages.tspdefines no default forfunction_fillers,speech_fillers, orparams. - "Same shape and translation behavior as
fillers" holds:fillersandfunction_fillersare bothstring[] | FunctionFillersinai_multilingual.tspwith matching descriptions. - The resolution-order text cut from the prompt page still lives at
swaig#filler-language-codes, so nothing is lost. ##to#in the Python comments is correct.- No slugs changed and nothing links to the guide's heading anchors, so no nav or redirect work is needed.
Optional nits
voice-language.mdx:2: the title "Voice and language" is now the only sentence-case sidebar label among its 33 Title Case siblings inbuild-ai-agents. It's correct permdx-style, so fine to keep. Just flagging the visual inconsistency until the rest get swept.- The PR description says
hide_title: falsewas removed fromgoogle.mdx, but on main that file only hasid:, and the diff correctly removes onlyid:. Description only, no code change needed. multilingual/index.mdx:143: optionally linkfillersto the param directly above it.- Untouched em dashes remain in
voice-language.mdx(lines 74, 264),prompt/index.mdx(22-28), and thelanguages[].modeldescription. Out of scope here, worth a separate sweep.
Manny-r31
approved these changes
Oct 28, 2026
Manny-r31
approved these changes
Oct 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
Finishes the legacy cleanup that #598 tracks on the AI reference pages #578 touched.
id:andhide_title: falsefromai/languages,ai/prompt, and the Google Cloud TTS page, plusunlisted: falsefromai/languages. Nothing in the repo references the ids.unlisted: falsehid nothing, so removing it publishes nothing new. Slugs are unchanged.default="None"removed fromlanguages[].function_fillers,.model,.speech_fillers, and.params. The TypeSpec gives none of these four a default.enter_fillerssentence giving the key resolution order repeated the canonical text on the SWAIG page's Filler language codes word for word. It's cut, and the existing link now says that page has the order.function_fillersrepeated two sentences fromfillersword for word. It now says "Same shape and translation behavior asfillers" (both arestring[] | FunctionFillersin the spec).##and use sentence case. The title is "Voice and language", which matchesfern/llms.txt, and Python comments use#instead of##. No links in the repo point at the old heading anchors.Already done on main, so not touched here: the Google Cloud
## Languagesvoice names, and the bare-voice-id warning, which now appears once onai/languageswith a one-line cross-reference.Closes #598
Notes for reviewers
ai/languages/index.mdx(adds text around thevoicestrings section and the warning) andai/prompt/index.mdx(contexts, steps,prompt.model,confidence). It doesn't touch any item in this PR, and this PR stays out of its hunks. A test merge of the two heads is clean.voice-languageguide still opens with a## Voice configuration overviewheading rather than an intro paragraph, the reference pages keep their bold## **Properties**/## **Examples**headings, andgoogle.mdxhas nomax-toc-depth..tspdescriptions for multilingualfunction_fillersstill repeat thefillerstext. Each spec description has to read on its own in the generated schema, so the spec is unchanged and noyarn build:specswas needed.Verification
yarn fern-md-check: all MDX files valid.#filler-language-codesby hand against the SWAIG page (slug: reference/calling/ai/swaig,### Filler language codes).Preview: