update docs for BDD interface