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

feat(helm-charts-docs) Automatic readme generation for chart #1209

Merged
merged 11 commits into from
Dec 3, 2020

Conversation

tharun208
Copy link
Contributor

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 automatically
annotates the value.

@tharun208 tharun208 requested a review from a team as a code owner November 24, 2020 19:24
@tharun208 tharun208 force-pushed the feat/helm_docs branch 3 times, most recently from 7e8d948 to 7608c60 Compare November 24, 2020 19:41
@tharun208 tharun208 marked this pull request as draft November 25, 2020 04:54
done by using helm-docs to pull out metadata from values.yml

Signed-off-by: Tharun <[email protected]>
@nickolaev
Copy link
Contributor

Please just mark as Draft, no need to put WIP in the title

@nickolaev nickolaev changed the title [WIP] feat(helm-charts-docs) Automatic readme generation for chart feat(helm-charts-docs) Automatic readme generation for chart Nov 25, 2020
@jakubdyszkiewicz
Copy link
Contributor

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
Copy link
Contributor

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?

Copy link
Contributor

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

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure ! will do it

Copy link
Contributor

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

Copy link
Contributor Author

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

@tharun208 tharun208 force-pushed the feat/helm_docs branch 2 times, most recently from c4aa54a to ace66d7 Compare November 25, 2020 19:17
@tharun208 tharun208 marked this pull request as ready for review November 25, 2020 21:08
@tharun208 tharun208 closed this Nov 25, 2020
@tharun208 tharun208 reopened this Nov 25, 2020
Copy link
Contributor

@nickolaev nickolaev left a 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.

@nickolaev
Copy link
Contributor

@Mergifyio update

@mergify
Copy link
Contributor

mergify bot commented Dec 1, 2020

Command update: failure

Branch update failed
merge conflict between base and head
err-code: 00A6D

Signed-off-by: Tharun <[email protected]>
@nickolaev
Copy link
Contributor

Will merge this one post 1.0.2 release today.

@nickolaev
Copy link
Contributor

@tharun208 will you please fix conflicts

Signed-off-by: Tharun <[email protected]>
Copy link
Contributor

@austince austince left a 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

@austince austince merged commit 56550e0 into kumahq:master Dec 3, 2020
mergify bot pushed a commit that referenced this pull request Dec 3, 2020
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
@tharun208 tharun208 deleted the feat/helm_docs branch December 3, 2020 18:35
nickolaev pushed a commit that referenced this pull request Dec 4, 2020
… (#1274)

* feat(kuma-cp) automatic readme generation for chart (#1209)

Co-authored-by: Tharun Rajendran <[email protected]>
Co-authored-by: Nikolay Nikolaev <[email protected]>
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.

4 participants