This piece argues that bbt turns README examples into executable tests, so the docs become the spec and the test suite in one place - which is neat, assuming people actually keep the README up to date.
The “keep the README up to date” part is exactly where I’ve seen this fall over, unless you keep the examples tiny and stable.
