document and minor updates