add docs, minor refactor
update change log for next release