add docs and minor updates