doc'ing deprecated bin api [skip ci]
Merge pull request #468 from calabash/feature/doc-deprecated-bin-api

doc'ing deprecated bin api