Skip to content

Commit

Permalink
chore: automated docs generation for release
Browse files Browse the repository at this point in the history
Co-authored-by: BekahHW <34313413+BekahHW@users.noreply.github.com>
  • Loading branch information
open-sauced[bot] and BekahHW committed Sep 10, 2024
1 parent fcf9e9f commit 07bac4b
Show file tree
Hide file tree
Showing 14 changed files with 34 additions and 31 deletions.
2 changes: 1 addition & 1 deletion docs/pizza.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ pizza <command> <subcommand> [flags]
### Options

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-h, --help help for pizza
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_completion.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ See each sub-command's help for details on how to use the generated script.
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_completion_bash.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ pizza completion bash
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_completion_fish.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ pizza completion fish [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_completion_powershell.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ pizza completion powershell [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_completion_zsh.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ pizza completion zsh [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
7 changes: 1 addition & 6 deletions docs/pizza_generate.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,6 @@ Generates documentation and insights from your codebase

The 'generate' command provides tools to automate the creation of important project documentation and derive insights from your codebase.

Currently, it supports generating CODEOWNERS files.

Available subcommands:
- codeowners: Generate a more granular GitHub-style CODEOWNERS file based on git history.

```
pizza generate [subcommand] [flags]
```
Expand All @@ -24,7 +19,7 @@ pizza generate [subcommand] [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
34 changes: 21 additions & 13 deletions docs/pizza_generate_codeowners.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,17 @@ Generate a CODEOWNERS file for a GitHub repository using a "~/.sauced.yaml" conf

### Synopsis

Generates a CODEOWNERS file for a given git repository. This uses a ~/.sauced.yaml configuration to attribute emails with given entities.
Generates a CODEOWNERS file for a given git repository. The generated file specifies up to 3 owners for EVERY file in the git tree based on the number of lines touched in that specific file over the specified range of time.

The generated file specifies up to 3 owners for EVERY file in the git tree based on the number of lines touched in that specific file over the specified range of time.
Configuration:
The command requires a .sauced.yaml file for accurate attribution. This file maps
commit email addresses to GitHub usernames. The command looks for this file in two locations:

1. In the root of the specified repository path
2. In the user's home directory (~/.sauced.yaml) if not found in the repository

If you run the command on a specific path, it will first look for .sauced.yaml in that
path. If not found, it will fall back to ~/.sauced.yaml.

```
pizza generate codeowners path/to/repo [flags]
Expand All @@ -16,20 +24,20 @@ pizza generate codeowners path/to/repo [flags]

```
# Generate CODEOWNERS file for the current directory
pizza generate codeowners .
# Generate CODEOWNERS file for the current directory
pizza generate codeowners .
# Generate CODEOWNERS file for a specific repository
pizza generate codeowners /path/to/your/repo
# Generate CODEOWNERS file for a specific repository
pizza generate codeowners /path/to/your/repo
# Generate CODEOWNERS file analyzing the last 180 days
pizza generate codeowners . --range 180
# Generate CODEOWNERS file analyzing the last 180 days
pizza generate codeowners . --range 180
# Generate an OWNERS style file instead of CODEOWNERS
pizza generate codeowners . --owners-style-file
# Generate an OWNERS style file instead of CODEOWNERS
pizza generate codeowners . --owners-style-file
# Specify a custom location for the .sauced.yaml file
pizza generate codeowners . --config /path/to/.sauced.yaml
# Specify a custom location for the .sauced.yaml file
pizza generate codeowners . --config /path/to/.sauced.yaml
```

Expand All @@ -44,7 +52,7 @@ pizza generate codeowners path/to/repo [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_insights.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ pizza insights <command> [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_insights_contributors.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ pizza insights contributors url... [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
-o, --output string The formatting for command output. One of: (table, yaml, csv, json) (default "table")
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_insights_repositories.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ pizza insights repositories url... [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
-o, --output string The formatting for command output. One of: (table, yaml, csv, json) (default "table")
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_insights_user-contributions.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ pizza insights user-contributions url... [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
-o, --output string The formatting for command output. One of: (table, yaml, csv, json) (default "table")
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_login.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ pizza login [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down
2 changes: 1 addition & 1 deletion docs/pizza_version.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ pizza version [flags]
### Options inherited from parent commands

```
-c, --config string The codeowners config (default ".sauced.yaml")
-c, --config string The codeowners config (default "~/.sauced.yaml")
--disable-telemetry Disable sending telemetry data to OpenSauced
-l, --log-level string The logging level. Options: error, warn, info, debug (default "info")
--tty-disable Disable log stylization. Suitable for CI/CD and automation
Expand Down

0 comments on commit 07bac4b

Please sign in to comment.