docs should be capitialized sentences [skip ci]
that todo comment is not important for public docs [skip ci]
Merge pull request #467 from calabash/feature/tidying-up-docs-for-top-level-module

tidying up docs for top level module