rst documentation comments for clearer arguments and paragraphs