M mdspec blog
All articles

Tag

Documentation

5 articles

Markdown CI/CD

Managing Markdown Bloat in AI-Era Repos

AI workflows generate markdown fast. ADRs, specs, meeting notes, agent outputs — it piles up. Here's how to sync it out, keep it searchable, and stop the sprawl.

6 min read
Specs Developer Tools

The Easy Way to Manage Specs in Your Repo

From Backstage to Confluence to plain wikis — managing engineering specs is a solved problem with many overcomplicated solutions. Here's a comparison, and a frictionless alternative.

8 min read
AI Documentation

The Documentation Gap No One Talks About in AI-Speed Development

AI makes developers faster. Much faster. But task documentation hasn't kept up. Here's what's being lost, why it matters, and how to close the gap before it becomes technical debt you can't see.

7 min read
AI Documentation

Don't Let AI Discussions Disappear — Write Them to Docs

Your most valuable architectural decisions are happening in AI chat sessions that vanish when the window closes. Here's how to capture them, store them, and make them searchable across your team's tools.

6 min read
S3 GitHub

The Easiest Way to Sync Markdown Files to S3 from GitHub

S3 is an ideal archive and distribution layer for engineering docs — durable, cheap, and searchable. Here's how to sync from your repo with minimal setup, using mdspec or a native Actions approach.

6 min read