[GenerateDocCReference] Improve filtering and categorization of arguments in documentation with sectionTitle

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorDoccReference().md

@@ -6,19 +6,21 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
-- term **--fav=\<fav\>**:
+### Options
+
+- term **--fav=\<fav\>:**
 
 *Your favorite color.*
 
 
-- term **--second=\<second\>**:
+- term **--second=\<second\>:**
 
 *Your second favorite color.*
 
 This is optional.
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
@@ -31,9 +33,8 @@ Show subcommand help information.
 color help [<subcommands>...] 
 ```
 
-- term **subcommands**:
-
-
-
+### Arguments
 
+- term **subcommands:**
 
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorMarkdownReference().md

@@ -6,6 +6,8 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
+### Options
+
 **--fav=\<fav\>:**
 
 *Your favorite color.*
@@ -31,9 +33,8 @@ Show subcommand help information.
 color help [<subcommands>...] 
 ```
 
-**subcommands:**
-
-
-
+### Arguments
 
+**subcommands:**
 
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesDoccReference().md

@@ -6,22 +6,26 @@
 count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 ```
 
-- term **input-file**:
+### Arguments
+
+- term **input-file:**
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
-- term **--prefix=\<prefix\>**:
+### Options
+
+- term **--prefix=\<prefix\>:**
 
 *Only count lines with this prefix.*
 
 
-- term **--verbose**:
+- term **--verbose:**
 
 *Include extra information in the output.*
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
@@ -34,9 +38,8 @@ Show subcommand help information.
 count-lines help [<subcommands>...] 
 ```
 
-- term **subcommands**:
-
-
-
+### Arguments
 
+- term **subcommands:**
 
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesMarkdownReference().md

@@ -6,11 +6,15 @@
 count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 ```
 
+### Arguments
+
 **input-file:**
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
+### Options
+
 **--prefix=\<prefix\>:**
 
 *Only count lines with this prefix.*
@@ -34,9 +38,8 @@ Show subcommand help information.
 count-lines help [<subcommands>...] 
 ```
 
-**subcommands:**
-
-
-
+### Arguments
 
+**subcommands:**
 
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathDoccReference().md

@@ -8,12 +8,14 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
-- term **--version**:
+### Options
+
+- term **--version:**
 
 *Show the version.*
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
@@ -26,27 +28,28 @@ Print the sum of the values.
 math add [--hex-output] [<values>...] [--version] [--help]
 ```
 
-- term **--hex-output**:
-
-*Use hexadecimal notation for the result.*
-
+### Arguments
 
-- term **values**:
+- term **values:**
 
 *A group of integers to operate on.*
 
 
-- term **--version**:
+### Options
 
-*Show the version.*
+- term **--hex-output:**
+
+*Use hexadecimal notation for the result.*
 
 
-- term **--help**:
+- term **--version:**
 
-*Show help information.*
+*Show the version.*
 
 
+- term **--help:**
 
+*Show help information.*
 
 ## math.multiply
 
@@ -56,27 +59,28 @@ Print the product of the values.
 math multiply [--hex-output] [<values>...] [--version] [--help]
 ```
 
-- term **--hex-output**:
-
-*Use hexadecimal notation for the result.*
+### Arguments
 
-
-- term **values**:
+- term **values:**
 
 *A group of integers to operate on.*
 
 
-- term **--version**:
+### Options
 
-*Show the version.*
+- term **--hex-output:**
 
+*Use hexadecimal notation for the result.*
 
-- term **--help**:
 
-*Show help information.*
+- term **--version:**
 
+*Show the version.*
 
 
+- term **--help:**
+
+*Show help information.*
 
 ## math.stats
 
@@ -86,12 +90,14 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
-- term **--version**:
+### Options
+
+- term **--version:**
 
 *Show the version.*
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
@@ -104,27 +110,28 @@ Print the average of the values.
 math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 ```
 
-- term **--kind=\<kind\>**:
-
-*The kind of average to provide.*
-
+### Arguments
 
-- term **values**:
+- term **values:**
 
 *A group of floating-point values to operate on.*
 
 
-- term **--version**:
+### Options
 
-*Show the version.*
+- term **--kind=\<kind\>:**
 
+*The kind of average to provide.*
 
-- term **--help**:
 
-*Show help information.*
+- term **--version:**
+
+*Show the version.*
 
 
+- term **--help:**
 
+*Show help information.*
 
 ### math.stats.stdev
 
@@ -134,23 +141,24 @@ Print the standard deviation of the values.
 math stats stdev [<values>...] [--version] [--help]
 ```
 
-- term **values**:
+### Arguments
+
+- term **values:**
 
 *A group of floating-point values to operate on.*
 
 
-- term **--version**:
+### Options
+
+- term **--version:**
 
 *Show the version.*
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
-
-
-
 ### math.stats.quantiles
 
 Print the quantiles of the values (TBD).
@@ -159,49 +167,48 @@ Print the quantiles of the values (TBD).
 math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<values>...]     [--file=<file>] [--directory=<directory>] [--shell=<shell>] [--custom=<custom>] [--custom-deprecated=<custom-deprecated>] [--version] [--help]
 ```
 
-- term **one-of-four**:
+### Arguments
 
+- term **one-of-four:**
 
-- term **custom-arg**:
 
+- term **custom-arg:**
 
-- term **custom-deprecated-arg**:
 
+- term **custom-deprecated-arg:**
 
-- term **values**:
+
+- term **values:**
 
 *A group of floating-point values to operate on.*
 
 
-- term **--file=\<file\>**:
+### Options
+
+- term **--file=\<file\>:**
 
 
-- term **--directory=\<directory\>**:
+- term **--directory=\<directory\>:**
 
 
-- term **--shell=\<shell\>**:
+- term **--shell=\<shell\>:**
 
 
-- term **--custom=\<custom\>**:
+- term **--custom=\<custom\>:**
 
 
-- term **--custom-deprecated=\<custom-deprecated\>**:
+- term **--custom-deprecated=\<custom-deprecated\>:**
 
 
-- term **--version**:
+- term **--version:**
 
 *Show the version.*
 
 
-- term **--help**:
+- term **--help:**
 
 *Show help information.*
 
-
-
-
-
-
 ## math.help
 
 Show subcommand help information.
@@ -210,14 +217,15 @@ Show subcommand help information.
 math help [<subcommands>...]  [--version]
 ```
 
-- term **subcommands**:
-
+### Arguments
 
-- term **--version**:
-
-*Show the version.*
+- term **subcommands:**
 
+*The subcommand(s) you want help for.*
 
 
+### Options
 
+- term **--version:**
 
+*Show the version.*