updating docs, still need to remove strange things from `CONTRIBUTING.rst`
refs #4