doc: tweaks to scatter docs