Docs that never lie

📰 Dev.to · Lionel Draghi

Turn your README into a living spec with executable examples using bbt

intermediate Published 20 Feb 2026
Action Steps
  1. Install bbt to embed executable examples into your test suite
  2. Write executable examples in your README using bbt syntax
  3. Run bbt to test and validate your examples
  4. Integrate bbt with your CI/CD pipeline to automate testing
  5. Use bbt to generate living documentation that reflects your code's behavior
Who Needs to Know This

Developers and DevOps teams can benefit from this approach to ensure documentation accuracy and automate testing

Key Insight

💡 Executable examples in your README can ensure documentation accuracy and automate testing

Share This
📄 Turn your README into a living spec with executable examples using bbt! 💻

Key Takeaways

Turn your README into a living spec with executable examples using bbt

Full Article

Turn your README into a living spec: bbt embeds executable examples directly into your test suite....
Read full article → ← Back to Reads