added support for lists and fixed a bunch of misc stuff
doc fixes
Update TODOs
Merge upstream.
Manual merge of cf99740f16335e1d67e606f983eab7296da913ae
Doc updates. Semver.
Merge pull request #2 from ninowalker/refactor_1

Upstream merge, plus a few enhancements.