final tweaks and doc update