Index: docs/CodingStandards.rst =================================================================== --- docs/CodingStandards.rst +++ docs/CodingStandards.rst @@ -321,7 +321,9 @@ be inferred from the API name. The first sentence (or a paragraph beginning with ``\brief``) is used as an abstract. Try to use a single sentence as the ``\brief`` adds visual clutter. Put detailed discussion into separate -paragraphs. +paragraphs. Avoid duplicating documentation for overridden methods. When +extending documentation from the superclass, the ``\copydoc name`` command can +be used. To refer to parameter names inside a paragraph, use the ``\p name`` command. Don't use the ``\arg name`` command since it starts a new paragraph that