Would be great to have a dynamic Readme generated from tests (eg. RSpec etc...)
I wrote a specification-test framework that does this:
https://github.com/hitchdev/hitchstory
Project with README that is partially generated from the code samples in the tests:
https://github.com/crdoconnor/strictyaml
with the README template:
https://github.com/crdoconnor/strictyaml/blob/master/docs/in...
that grabs code snippets and their expected outputs from the story:
https://github.com/crdoconnor/strictyaml/blob/master/hitch/s...