From 2f08b8bc3b2e8eec7880aafa3c9dc0f1174b866f Mon Sep 17 00:00:00 2001 From: Aleksej Komarov Date: Sun, 1 Nov 2020 07:27:38 +0200 Subject: [PATCH] Use a more common documentation block standard. (#54623) --- .github/AUTODOC_GUIDE.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/.github/AUTODOC_GUIDE.md b/.github/AUTODOC_GUIDE.md index 63d6b81c0bd..3433c1cc53e 100644 --- a/.github/AUTODOC_GUIDE.md +++ b/.github/AUTODOC_GUIDE.md @@ -43,14 +43,14 @@ namespace), then a longer paragraph which will be shown when the user clicks on the proc to jump to it's definition ``` /** - * Short description of the proc - * - * Longer detailed paragraph about the proc - * including any relevant detail - * Arguments: - * * arg1 - Relevance of this argument - * * arg2 - Relevance of this argument - */ + * Short description of the proc + * + * Longer detailed paragraph about the proc + * including any relevant detail + * Arguments: + * * arg1 - Relevance of this argument + * * arg2 - Relevance of this argument + */ ``` ### Documenting a class @@ -62,15 +62,15 @@ Then we give a short oneline description of the class Finally we give a longer multi paragraph description of the class and it's details ``` /** - * # Classname (Can be omitted if it's just going to be the typepath) - * - * The short overview - * - * A longer - * paragraph of functionality about the class - * including any assumptions/special cases - * - */ + * # Classname (Can be omitted if it's just going to be the typepath) + * + * The short overview + * + * A longer + * paragraph of functionality about the class + * including any assumptions/special cases + * + */ ``` ### Documenting a variable/define