fix: update argument categorization logic to match ArgumentParser standard help output

Author: Chamepp

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorDoccReference().md

@@ -6,13 +6,6 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
-### Flags
-
-- term **--help:**
-
-*Show help information.*
-
-
 ### Options
 
 - term **--fav=\<fav\>:**
@@ -27,6 +20,11 @@ color --fav=<fav> [--second=<second>] [--help]
 This is optional.
 
 
+- term **--help:**
+
+*Show help information.*
+
+
 ## color.help
 
 Show subcommand help information.
@@ -38,3 +36,5 @@ color help [<subcommands>...]
 ### Arguments
 
 - term **subcommands:**
+
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorMarkdownReference().md

@@ -6,13 +6,6 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
-### Flags
-
-**--help:**
-
-*Show help information.*
-
-
 ### Options
 
 **--fav=\<fav\>:**
@@ -27,6 +20,11 @@ color --fav=<fav> [--second=<second>] [--help]
 This is optional.
 
 
+**--help:**
+
+*Show help information.*
+
+
 ## color.help
 
 Show subcommand help information.
@@ -38,3 +36,5 @@ color help [<subcommands>...]
 ### Arguments
 
 **subcommands:**
+
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesDoccReference().md

@@ -13,7 +13,12 @@ count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
-### Flags
+### Options
+
+- term **--prefix=\<prefix\>:**
+
+*Only count lines with this prefix.*
+
 
 - term **--verbose:**
 
@@ -25,13 +30,6 @@ 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.
@@ -43,3 +41,5 @@ count-lines help [<subcommands>...]
 ### Arguments
 
 - term **subcommands:**
+
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesMarkdownReference().md

@@ -13,7 +13,12 @@ count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
-### Flags
+### Options
+
+**--prefix=\<prefix\>:**
+
+*Only count lines with this prefix.*
+
 
 **--verbose:**
 
@@ -25,13 +30,6 @@ 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.
@@ -43,3 +41,5 @@ count-lines help [<subcommands>...]
 ### Arguments
 
 **subcommands:**
+
+*The subcommand(s) you want help for.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathDoccReference().md

@@ -8,7 +8,7 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
-### Flags
+### Options
 
 - term **--version:**
 
@@ -35,7 +35,7 @@ math add [--hex-output] [<values>...] [--version] [--help]
 *A group of integers to operate on.*
 
 
-### Flags
+### Options
 
 - term **--hex-output:**
 
@@ -66,7 +66,7 @@ math multiply [--hex-output] [<values>...] [--version] [--help]
 *A group of integers to operate on.*
 
 
-### Flags
+### Options
 
 - term **--hex-output:**
 
@@ -90,7 +90,7 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
-### Flags
+### Options
 
 - term **--version:**
 
@@ -117,7 +117,12 @@ math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 *A group of floating-point values to operate on.*
 
 
-### Flags
+### Options
+
+- term **--kind=\<kind\>:**
+
+*The kind of average to provide.*
+
 
 - term **--version:**
 
@@ -128,13 +133,6 @@ math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 
 *Show help information.*
 
-
-### Options
-
-- term **--kind=\<kind\>:**
-
-*The kind of average to provide.*
-
 ### math.stats.stdev
 
 Print the standard deviation of the values.
@@ -150,7 +148,7 @@ math stats stdev [<values>...] [--version] [--help]
 *A group of floating-point values to operate on.*
 
 
-### Flags
+### Options
 
 - term **--version:**
 
@@ -185,18 +183,6 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<
 *A group of floating-point values to operate on.*
 
 
-### Flags
-
-- term **--version:**
-
-*Show the version.*
-
-
-- term **--help:**
-
-*Show help information.*
-
-
 ### Options
 
 - term **--file=\<file\>:**
@@ -213,6 +199,16 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<
 
 - term **--custom-deprecated=\<custom-deprecated\>:**
 
+
+- term **--version:**
+
+*Show the version.*
+
+
+- term **--help:**
+
+*Show help information.*
+
 ## math.help
 
 Show subcommand help information.
@@ -225,8 +221,10 @@ math help [<subcommands>...]  [--version]
 
 - term **subcommands:**
 
+*The subcommand(s) you want help for.*
 
-### Flags
+
+### Options
 
 - term **--version:**
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathMarkdownReference().md

@@ -8,7 +8,7 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
-### Flags
+### Options
 
 **--version:**
 
@@ -35,7 +35,7 @@ math add [--hex-output] [<values>...] [--version] [--help]
 *A group of integers to operate on.*
 
 
-### Flags
+### Options
 
 **--hex-output:**
 
@@ -66,7 +66,7 @@ math multiply [--hex-output] [<values>...] [--version] [--help]
 *A group of integers to operate on.*
 
 
-### Flags
+### Options
 
 **--hex-output:**
 
@@ -90,7 +90,7 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
-### Flags
+### Options
 
 **--version:**
 
@@ -117,7 +117,12 @@ math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 *A group of floating-point values to operate on.*
 
 
-### Flags
+### Options
+
+**--kind=\<kind\>:**
+
+*The kind of average to provide.*
+
 
 **--version:**
 
@@ -128,13 +133,6 @@ math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 
 *Show help information.*
 
-
-### Options
-
-**--kind=\<kind\>:**
-
-*The kind of average to provide.*
-
 ### math.stats.stdev
 
 Print the standard deviation of the values.
@@ -150,7 +148,7 @@ math stats stdev [<values>...] [--version] [--help]
 *A group of floating-point values to operate on.*
 
 
-### Flags
+### Options
 
 **--version:**
 
@@ -185,18 +183,6 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<
 *A group of floating-point values to operate on.*
 
 
-### Flags
-
-**--version:**
-
-*Show the version.*
-
-
-**--help:**
-
-*Show help information.*
-
-
 ### Options
 
 **--file=\<file\>:**
@@ -213,6 +199,16 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>] [<
 
 **--custom-deprecated=\<custom-deprecated\>:**
 
+
+**--version:**
+
+*Show the version.*
+
+
+**--help:**
+
+*Show help information.*
+
 ## math.help
 
 Show subcommand help information.
@@ -225,8 +221,10 @@ math help [<subcommands>...]  [--version]
 
 **subcommands:**
 
+*The subcommand(s) you want help for.*
 
-### Flags
+
+### Options
 
 **--version:**