adding reference to BDD tests

add link to integration test
fix formatting issue for note/caution on paging section