write up docs and visibility modifiers on the Core module

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