Documentation

[anseljh]

We should write up some real documentation. I'm happy to help!

I see at least these areas:

1. Markup
2. How to use the web app
3. How to use the CLI
4. How to contribute to development

Some good points for us to keep in mind:

• http://www.erikaheidi.com/blog/is-your-open-source-project-welcoming-to-new-contributors
• https://the-pastry-box-project.net/charlotte-spencer/2015-september-16

[anseljh]

@kemitchell what are your feelings about API docs (i.e., generated with ESDoc, JSDoc, etc.)? I'm on the fence about whether they would be worth the effort.

[kemitchell]

Until someone needs API docs in particular, I prefer to keep things as lean as possible.

I should probably comment more. But I think I've done alright keeping packages small. The tests-in-README thing is a bit eccentric, but I find it does the job most of the time.