Examples - Behave API suite

[luisgj]

Add the example BDD suite for the api scenarios in the examples repo.
Add a readable README file with instructions to run it.
Add a new "BDD suite" page in the docs.