more tweaks and minor doc updates