improve docs (formatting mostly)