write up docs and visibility modifiers 

This adds documentation for all the methods in `Calabash::Cucumber::Core`.

- [x] @jmoody - please review