Currently missing points:
- No outputs should be included in the notebooks
- we do prefer
.md files as opposed to .ipynb.
Maybe the updated guide should be in a separate file, and keep the absolute newcomer version, that we currently have, in the README?