Skip to content
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.

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

fix(scripts/helm-docs): ignore dependency helm charts when generating README.md #435

Merged
merged 1 commit into from
Mar 14, 2024

Conversation

niladrih
Copy link
Member

The script /scripts/helm/generate-readme.sh generates documentation for all charts present inside the /chart directory. The helm-docs tool recursively walks through all charts in the directory and generates docs for them. This is inconvenient if there are dependency charts inside the /chart/charts directory. We don't necessarily want to add documentation for these charts to the README.md The -g option disables this.

-g, --chart-to-generate strings    List of charts that will have documentation generated. Comma separated, no space. Empty list - generate for all charts in chart-search-root

@niladrih
Copy link
Member Author

bors merge

bors-openebs-mayastor bot pushed a commit that referenced this pull request Mar 14, 2024
435: fix(scripts/helm-docs): ignore dependency helm charts when generating README.md r=niladrih a=niladrih

The script `/scripts/helm/generate-readme.sh` generates documentation for all charts present inside the `/chart` directory. The `helm-docs` tool recursively walks through all charts in the directory and generates docs for them. This is inconvenient if there are dependency charts inside the `/chart/charts` directory. We don't necessarily want to add documentation for these charts to the README.md The `-g` option disables this.
```console
-g, --chart-to-generate strings    List of charts that will have documentation generated. Comma separated, no space. Empty list - generate for all charts in chart-search-root
```

Co-authored-by: Niladri Halder <niladri.halder26@gmail.com>
@niladrih
Copy link
Member Author

bors merge

@bors-openebs-mayastor
Copy link
Contributor

Already running a review

@niladrih
Copy link
Member Author

bors cancel

@bors-openebs-mayastor
Copy link
Contributor

Canceled.

@niladrih
Copy link
Member Author

bors merge

bors-openebs-mayastor bot pushed a commit that referenced this pull request Mar 14, 2024
435: fix(scripts/helm-docs): ignore dependency helm charts when generating README.md r=niladrih a=niladrih

The script `/scripts/helm/generate-readme.sh` generates documentation for all charts present inside the `/chart` directory. The `helm-docs` tool recursively walks through all charts in the directory and generates docs for them. This is inconvenient if there are dependency charts inside the `/chart/charts` directory. We don't necessarily want to add documentation for these charts to the README.md The `-g` option disables this.
```console
-g, --chart-to-generate strings    List of charts that will have documentation generated. Comma separated, no space. Empty list - generate for all charts in chart-search-root
```

Co-authored-by: Niladri Halder <niladri.halder26@gmail.com>
@bors-openebs-mayastor
Copy link
Contributor

Build failed:

… README.md

Signed-off-by: Niladri Halder <niladri.halder26@gmail.com>
@niladrih
Copy link
Member Author

bors merge

@bors-openebs-mayastor
Copy link
Contributor

🕐 Waiting for PR status (Github check) to be set, probably by CI. Bors will automatically try to run when all required PR statuses are set.

bors-openebs-mayastor bot pushed a commit that referenced this pull request Mar 14, 2024
435: fix(scripts/helm-docs): ignore dependency helm charts when generating README.md r=niladrih a=niladrih

The script `/scripts/helm/generate-readme.sh` generates documentation for all charts present inside the `/chart` directory. The `helm-docs` tool recursively walks through all charts in the directory and generates docs for them. This is inconvenient if there are dependency charts inside the `/chart/charts` directory. We don't necessarily want to add documentation for these charts to the README.md The `-g` option disables this.
```console
-g, --chart-to-generate strings    List of charts that will have documentation generated. Comma separated, no space. Empty list - generate for all charts in chart-search-root
```

Co-authored-by: Niladri Halder <niladri.halder26@gmail.com>
@niladrih
Copy link
Member Author

bors cancel

@bors-openebs-mayastor
Copy link
Contributor

Canceled.

@niladrih
Copy link
Member Author

bors merge

@bors-openebs-mayastor
Copy link
Contributor

Build succeeded:

@bors-openebs-mayastor bors-openebs-mayastor bot merged commit 75291f8 into develop Mar 14, 2024
5 checks passed
@bors-openebs-mayastor bors-openebs-mayastor bot deleted the helm-docs branch March 14, 2024 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants