docs and minor improvements