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

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorDoccReference().md

@@ -6,6 +6,15 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
+### Flags
+
+- term **--help:**
+
+*Show help information.*
+
+
+### Options
+
 - term **--fav=\<fav\>:**
 
 *Your favorite color.*
@@ -18,11 +27,6 @@ color --fav=<fav> [--second=<second>] [--help]
 This is optional.
 
 
-- term **--help:**
-
-*Show help information.*
-
-
 ## color.help
 
 Show subcommand help information.
@@ -31,9 +35,6 @@ Show subcommand help information.
 color help [<subcommands>...] 
 ```
 
-- term **subcommands:**
-
-
-
-
+### Arguments
 
+- term **subcommands:**

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorMarkdownReference().md

@@ -6,6 +6,15 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
+### Flags
+
+**--help:**
+
+*Show help information.*
+
+
+### Options
+
 **--fav=\<fav\>:**
 
 *Your favorite color.*
@@ -18,11 +27,6 @@ color --fav=<fav> [--second=<second>] [--help]
 This is optional.
 
 
-**--help:**
-
-*Show help information.*
-
-
 ## color.help
 
 Show subcommand help information.
@@ -31,9 +35,6 @@ Show subcommand help information.
 color help [<subcommands>...] 
 ```
 
-**subcommands:**
-
-
-
-
+### Arguments
 
+**subcommands:**

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesDoccReference().md

@@ -6,15 +6,14 @@
 count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 ```
 
+### Arguments
+
 - term **input-file:**
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
-- term **--prefix=\<prefix\>:**
-
-*Only count lines with this prefix.*
-
+### Flags
 
 - term **--verbose:**
 
@@ -26,6 +25,13 @@ count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 *Show help information.*
 
 
+### Options
+
+- term **--prefix=\<prefix\>:**
+
+*Only count lines with this prefix.*
+
+
 ## count-lines.help
 
 Show subcommand help information.
@@ -34,9 +40,6 @@ Show subcommand help information.
 count-lines help [<subcommands>...] 
 ```
 
-- term **subcommands:**
-
-
-
-
+### Arguments
 
+- term **subcommands:**

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesMarkdownReference().md

@@ -6,15 +6,14 @@
 count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 ```
 
+### Arguments
+
 **input-file:**
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
-**--prefix=\<prefix\>:**
-
-*Only count lines with this prefix.*
-
+### Flags
 
 **--verbose:**
 
@@ -26,6 +25,13 @@ count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 *Show help information.*
 
 
+### Options
+
+**--prefix=\<prefix\>:**
+
+*Only count lines with this prefix.*
+
+
 ## count-lines.help
 
 Show subcommand help information.
@@ -34,9 +40,6 @@ Show subcommand help information.
 count-lines help [<subcommands>...] 
 ```
 
-**subcommands:**
-
-
-
-
+### Arguments
 
+**subcommands:**

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathDoccReference().md

@@ -8,6 +8,8 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
+### Flags
+
 - term **--version:**
 
 *Show the version.*
@@ -26,16 +28,20 @@ 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:**
 
 *A group of integers to operate on.*
 
 
+### Flags
+
+- term **--hex-output:**
+
+*Use hexadecimal notation for the result.*
+
+
 - term **--version:**
 
 *Show the version.*
@@ -45,9 +51,6 @@ math add [--hex-output] [<values>...] [--version] [--help]
 
 *Show help information.*
 
-
-
-
 ## math.multiply
 
 Print the product of the values.
@@ -56,16 +59,20 @@ 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:**
 
 *A group of integers to operate on.*
 
 
+### Flags
+
+- term **--hex-output:**
+
+*Use hexadecimal notation for the result.*
+
+
 - term **--version:**
 
 *Show the version.*
@@ -75,9 +82,6 @@ math multiply [--hex-output] [<values>...] [--version] [--help]
 
 *Show help information.*
 
-
-
-
 ## math.stats
 
 Calculate descriptive statistics.
@@ -86,6 +90,8 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
+### Flags
+
 - term **--version:**
 
 *Show the version.*
@@ -104,16 +110,15 @@ 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:**
 
 *A group of floating-point values to operate on.*
 
 
+### Flags
+
 - term **--version:**
 
 *Show the version.*
@@ -124,7 +129,11 @@ math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 *Show help information.*
 
 
+### Options
 
+- term **--kind=\<kind\>:**
+
+*The kind of average to provide.*
 
 ### math.stats.stdev
 
@@ -134,11 +143,15 @@ Print the standard deviation of the values.
 math stats stdev [<values>...] [--version] [--help]
 ```
 
+### Arguments
+
 - term **values:**
 
 *A group of floating-point values to operate on.*
 
 
+### Flags
+
 - term **--version:**
 
 *Show the version.*
@@ -148,9 +161,6 @@ math stats stdev [<values>...] [--version] [--help]
 
 *Show help information.*
 
-
-
-
 ### math.stats.quantiles
 
 Print the quantiles of the values (TBD).
@@ -159,6 +169,8 @@ 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]
 ```
 
+### Arguments
+
 - term **one-of-four:**
 
 
@@ -173,34 +185,33 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<
 *A group of floating-point values to operate on.*
 
 
-- term **--file=\<file\>:**
-
+### Flags
 
-- term **--directory=\<directory\>:**
-
-
-- term **--shell=\<shell\>:**
+- term **--version:**
 
+*Show the version.*
 
-- term **--custom=\<custom\>:**
 
+- term **--help:**
 
-- term **--custom-deprecated=\<custom-deprecated\>:**
+*Show help information.*
 
 
-- term **--version:**
+### Options
 
-*Show the version.*
+- term **--file=\<file\>:**
 
 
-- term **--help:**
+- term **--directory=\<directory\>:**
 
-*Show help information.*
 
+- term **--shell=\<shell\>:**
 
 
+- term **--custom=\<custom\>:**
 
 
+- term **--custom-deprecated=\<custom-deprecated\>:**
 
 ## math.help
 
@@ -210,9 +221,6 @@ Show subcommand help information.
 math help [<subcommands>...] 
 ```
 
-- term **subcommands:**
-
-
-
-
+### Arguments
 
+- term **subcommands:**