Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fcc8f21
[GenerateDocCReference] Improve filtering and categorization of argum…
Chamepp Apr 3, 2025
806544c
fix: handle the assignment of the default sectionTitle value in the g…
Chamepp Apr 3, 2025
49f9f69
fix: handling section titles in the GenerateDocc extension
Chamepp Apr 12, 2025
fa6f077
refactor: update markdown headers to align with DocC formatting
Chamepp Apr 20, 2025
fc96cbe
chore: resolve merge conflicts with upstream/main
Chamepp May 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 11 additions & 10 deletions .../ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorDoccReference().md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,15 @@
color --fav=<fav> [--second=<second>] [--help]
```

### Flags

- term **--help:**

*Show help information.*


### Options

- term **--fav=\<fav\>:**

*Your favorite color.*
Expand All @@ -18,11 +27,6 @@ color --fav=<fav> [--second=<second>] [--help]
This is optional.


- term **--help:**

*Show help information.*


## color.help

Show subcommand help information.
Expand All @@ -31,9 +35,6 @@ Show subcommand help information.
color help [<subcommands>...]
```

- term **subcommands:**




### Arguments

- term **subcommands:**
21 changes: 11 additions & 10 deletions ...umentParserGenerateDoccReferenceTests/Snapshots/testColorMarkdownReference().md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,15 @@
color --fav=<fav> [--second=<second>] [--help]
```

### Flags

**--help:**

*Show help information.*


### Options

**--fav=\<fav\>:**

*Your favorite color.*
Expand All @@ -18,11 +27,6 @@ color --fav=<fav> [--second=<second>] [--help]
This is optional.


**--help:**

*Show help information.*


## color.help

Show subcommand help information.
Expand All @@ -31,9 +35,6 @@ Show subcommand help information.
color help [<subcommands>...]
```

**subcommands:**




### Arguments

**subcommands:**
21 changes: 12 additions & 9 deletions ...mentParserGenerateDoccReferenceTests/Snapshots/testCountLinesDoccReference().md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:**

Expand All @@ -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.
Expand All @@ -34,9 +40,6 @@ Show subcommand help information.
count-lines help [<subcommands>...]
```

- term **subcommands:**




### Arguments

- term **subcommands:**
21 changes: 12 additions & 9 deletions ...ParserGenerateDoccReferenceTests/Snapshots/testCountLinesMarkdownReference().md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:**

Expand All @@ -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.
Expand All @@ -34,9 +40,6 @@ Show subcommand help information.
count-lines help [<subcommands>...]
```

**subcommands:**




### Arguments

**subcommands:**
84 changes: 46 additions & 38 deletions ...s/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathDoccReference().md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ A utility for performing maths.
math [--version] [--help]
```

### Flags

- term **--version:**

*Show the version.*
Expand All @@ -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.*
Expand All @@ -45,9 +51,6 @@ math add [--hex-output] [<values>...] [--version] [--help]

*Show help information.*




## math.multiply

Print the product of the values.
Expand All @@ -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.*
Expand All @@ -75,9 +82,6 @@ math multiply [--hex-output] [<values>...] [--version] [--help]

*Show help information.*




## math.stats

Calculate descriptive statistics.
Expand All @@ -86,6 +90,8 @@ Calculate descriptive statistics.
math stats [--version] [--help]
```

### Flags

- term **--version:**

*Show the version.*
Expand All @@ -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.*
Expand All @@ -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

Expand All @@ -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.*
Expand All @@ -148,9 +161,6 @@ math stats stdev [<values>...] [--version] [--help]

*Show help information.*




### math.stats.quantiles

Print the quantiles of the values (TBD).
Expand All @@ -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:**


Expand All @@ -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

Expand All @@ -210,9 +221,6 @@ Show subcommand help information.
math help [<subcommands>...]
```

- term **subcommands:**




### Arguments

- term **subcommands:**
Loading