docs: refresh examples and recipes pages - #1188
Merged
Merged
Conversation
The recipes page had not had a content change since April 2026 (the August commit was a site-wide metadata pass), while pipecat/examples/ gained roughly 100 new files in that window. Every link already on both pages still resolves; the drift was omission rather than rot. recipes.mdx: 19 -> 41 recipes, grouped under headings since a flat list of 41 is hard to scan. Adds the categories that were missing entirely: context summarization, persistent context, RAG/Mem0, reasoning models, runtime service settings, voice formatting and text transforms, DTMF menus, live translation, and pipeline reliability (ServiceSwitcher, is_usable, app_resources, heartbeats). Existing entries keep their text and links verbatim. overview.mdx: +8 single-agent, +8 multi-agent. The multi-agent gap was the largest -- the whole ui-worker/ suite plus sensor-controller and openclaw-agent landed after that section was written. New single-agent entries: Instant Voice, Speculative Inference, SMS Verification, PhoneLLM, AWS Strands, Bedrock AgentCore, Multi-Language Translation, and S3 audio recording. Descriptions are drawn from the examples' own docstrings and READMEs. Per-provider directories (function-calling/, voice/) stay behind the "More Recipes" card rather than being listed individually. Claude-Session: https://claude.ai/code/session_01SrQCYMWzMeLo6y4BpeuFEN
Contributor
|
🔍 Mintlify preview for this branch: https://daily-mb-examples-updates.mintlify.site |
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
1 participant
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
The recipes page hadn't had a content change since April 2026 (the August commit was a site-wide metadata pass), while
pipecat/examples/gained ~100 new files in that window. Every link already on both pages still resolves — I checked all 47 against GitHub — so the drift was omission, not rot.Changes
recipes.mdx: 19 → 41 recipes, now grouped under headings since a flat list of 41 is hard to scan. Whole categories were missing:ServiceSwitcher,is_usable,app_resources, heartbeatsExisting entries keep their text and links verbatim.
overview.mdx: +8 single-agent, +8 multi-agent. The multi-agent gap was the biggest — the wholeui-worker/suite (6 examples) plussensor-controllerandopenclaw-agentlanded after that section was written. New single-agent entries: Instant Voice, Speculative Inference, SMS Verification, PhoneLLM, AWS Strands, Bedrock AgentCore, Multi-Language Translation, S3 audio recording.Descriptions are drawn from the examples' own docstrings and READMEs, not guessed from filenames.
Verification
mint broken-links --check-anchors --check-redirects— passesdocs-meta-lint.mjs— 0 errors (188 warnings, unchanged from baseline)llms.txt/llms-full.txtregeneratedNotes for review
function-calling/alone has 40+ provider variants andvoice/has 60+; listing them individually would bury the techniques, so those directories stay behind the "More Recipes" card. Also skippedfeatures-add-tool-change-messages.py, which describes itself as a manual validation harness rather than a recipe.npm run formatalso reformats a table inpipecat-cloud/guides/telephony/daily-dial-out.mdx. I reverted that to keep this diff focused, so it's still un-clean onmain— contrary to CLAUDE.md,npm run formatis not currently a no-op on a clean tree.llms.txtis over its cap at 100,086 / 100,000 (warning, not error). Verified viagit stashthat this is identical before and after — the projection is driven by nav page titles and descriptions, which this PR doesn't touch. Needs attention on its own.🤖 Generated with Claude Code
https://claude.ai/code/session_01SrQCYMWzMeLo6y4BpeuFEN