documentation and plotting tweaks