first go at rewriting README
# Stencila Documentation
+
+Stencila is the open-source office suite for reproducible research. It is intuitive and easy to use for all researchers and their collaborators.
+If you do not write code to advance your research, Stencila will offer you friendly environment with familiar
+user interface. If you are a coder, you will be able to seamlessly integrate your source code (in almost any language) with stencila
+enabling other researchers to deploy your code in their work.
+
+This website provides comprehensive documentation for Stencila.
+
+See the [Stencila technical reference documentation](https://stencila.github.io/stencila)
+
+### Contributing
+
+Stencila is a community-driven project.
+We encourage and welcome contributions from all community members. You can contribute to a
+whole variety of Stencila components and in many different ways: from
+contributing new source code and documentation, to providing feedback on
+Stencila and making suggestions for improvements.
+
+**In particular, if you would like to help with this documentation:**
+
+Documentation files are written in [Markdown][markdown]. The documentation source
+files are contained in the main [Stencila repository][stencila-repo]. As per the instructions
+above, we welcome all contributions submitted by [opening an issue](https://github.com/stencila/stencila/issues),
+sending us a Pull Request or simply an [email][contact].
+
+
+## Get in touch!
+
+You can chat with the team at our [community forum][community-forum],
+on Twitter [@Stencila][stencila-twitter],
+[Gitter][stencila-gitter], or email to [hello@stenci.la][contact]
+
+[contact]: mailto:hello@stenci.la
+[community-forum]: https://github.com/stencila/libcore/blob/master/docs/community.stenci.la
+[issues]: https://help.github.com/articles/creating-an-issue/
+[stencila-site]: http://stenci.la/
+[stencila-repo]: https://github.com/stencila/stencila
+[stencila-twitter]: https://twitter.com/stencila
+[stencila-gitter]: https://gitter.im/stencila/stencila/
+[markdown]: https://daringfireball.net/projects/markdown
