documentation style readme

[Pomax]

we don't have any helpful guidelines on how to write a good README, it might be worth "documenting how to document" in terms of which sections should be in a README and what level of details those sections should go into.

Based on our work so far, we usually cover the following things:

• project description
• tool dependencies (node, git, etc)
• how to run the project
• how to set yourself up so you can work on the project (often more work than the point above)
• libraries: API details
• stand-alone: env vars
• further links, sometimes?