documentation fixups
improve docs