-
Notifications
You must be signed in to change notification settings - Fork 336
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
feat(helm-charts-docs) Automatic readme generation for chart #1209
Conversation
7e8d948
to
7608c60
Compare
done by using helm-docs to pull out metadata from values.yml Signed-off-by: Tharun <[email protected]>
7608c60
to
6d3e12d
Compare
Please just mark as Draft, no need to put WIP in the title |
That's super cool! I love the idea. |
mk/dev.mk
Outdated
@@ -182,6 +183,10 @@ dev/install/goimports: ## Bootstrap: Install goimports | |||
dev/install/helm3: ## Bootstrap: Install Helm 3 | |||
curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash | |||
|
|||
.PHONY: dev/install/helm-docs | |||
dev/install/helm-docs: ## Bootstrap: Install Helm Docs | |||
go get github.com/norwoodj/helm-docs/cmd/helm-docs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there any way to pin this to a version (even just major)? Maybe we could use the docker image as an alternative if not?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actually, there is a binary release available. Let's use that one:
https://github.com/norwoodj/helm-docs/releases
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
sure ! will do it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If we taking binaries, make sure to support Linux and MacOS
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
yes, it has support for both
c4aa54a
to
ace66d7
Compare
Signed-off-by: Tharun <[email protected]>
ace66d7
to
5032288
Compare
…ated readme Signed-off-by: Tharun <[email protected]>
5032288
to
65a93a3
Compare
Signed-off-by: Tharun <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we can go.
Signed-off-by: Tharun <[email protected]>
Signed-off-by: Tharun <[email protected]>
Signed-off-by: Tharun <[email protected]>
@Mergifyio update |
Command
|
Signed-off-by: Tharun <[email protected]>
Signed-off-by: Tharun <[email protected]>
Will merge this one post 1.0.2 release today. |
@tharun208 will you please fix conflicts |
Signed-off-by: Tharun <[email protected]>
Signed-off-by: Tharun <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Re-ran the CI and everything is passing, going to merge this before more conflicts get in
Signed-off-by: Tharun <[email protected]> (cherry picked from commit 56550e0) # Conflicts: # app/kumactl/pkg/install/k8s/control-plane/helmtemplates_vfsdata.go # mk/dev.mk
… (#1274) * feat(kuma-cp) automatic readme generation for chart (#1209) Co-authored-by: Tharun Rajendran <[email protected]> Co-authored-by: Nikolay Nikolaev <[email protected]>
The current readme for the chart is generated manually and doesn't contain all the information available.
Utilize helm-docs to automatically fill out the readme for the helm charts by pulling metadata from values.yml.
values.yml metadata
To allow helm-docs to properly document the values in values.yml a new-style comment is required.
Comment above the value with
# -- metadata to show in readme description
where the double dashes automaticallyannotates the value.