Document the interface API
Link to the BDD interface docs
Elaborate a bit more in the intro
Merge pull request #46 from pereckerdal/documentation

Document the interface API