Rails Daily: Markdown Becomes Default for API Docs
Markdown is now the default markup for Rails API documentation after months of migration, alongside README conversions across five frameworks. Underneath, a cluster of performance and cleanup changes speeds UUID casting, boot time, and attribute handling.
Duration: PT2M14S
Episode overview
This episode is a short developer briefing from Rails Daily.
It explains recent repository work in plain language.
- Show: Rails Daily
- Published: 2026-10-25T06:02:16Z
- Audio duration: PT2M14S
Transcript excerpt
This excerpt keeps the crawler page concise. Listen to the episode or use the RSS feed for the full update.
Good morning, it's Sunday, October 25th, 2026.
The lead signal is documentation as a behavior change: Markdown is now the default for the API docs, capping a months-long migration.
That shift centers on PR 59339, which passes Markdown to the docs generator and starts removing per-file markup hints. Files the current renderer can't handle — mainly code blocks nested in lists — stay on R Doc for now. Evidence of the rollout is everywhere: conversions for the Action Mailer, Action View, Active…
The second theme is quieter performance and maintainability work in Active Record and supporting layers. PR 59328 expands the PostgreSQL UUID validation pattern for about a two-times speedup in casting, building on an earlier fast path — meaningful if you use UUID primary keys at scale. PR 59336 replaces…
Finally, a small correctness fix worth knowing: PR 59340 lets tag helpers render the hidden until-found keyword, so find-in-page and fragment navigation can reveal content. Previously any truthy value rendered as hidden equals hidden, with no way to produce the new HTML behavior.
What's next: expect gradual Markdown conversions across remaining guides and comments, and watch the open proposal to…
Nearby episodes from Rails Daily
- Safer Requests and Faster Reads
- Filter Fixes, Analyzer Hardening, and Hot-Path Trims
- Weekly Recap - Allocation Cuts and Markdown by Default
- Symbol Savings and Silent Query Fixes
- Allocation Cuts and Query Fixes
- Bootsnap Caching Push and Association Fixes
- Security Fixes and Performance Sweep
- Efficiency Sweep and Query Correctness Fixes