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(sidekick-helm-doc): Values in README generated by helm docs #384

Merged
merged 1 commit into from
Jul 29, 2022

Conversation

Lowaiz
Copy link
Contributor

@Lowaiz Lowaiz commented Jul 28, 2022

Signed-off-by: Lyonel Martinez [email protected]

What type of PR is this?

/kind documentation

Any specific area of the project related to this PR?

/area falcosidekick-chart

What this PR does / why we need it:

Helm docs integration based on falco chart one's

Which issue(s) this PR fixes:
None

It seems that config.kafka.partition and config.kafka.messageformat was useless, the sidekick doesn't document these params. and they don't appear in the config parser, so I deleted them

@Lowaiz
Copy link
Contributor Author

Lowaiz commented Jul 28, 2022

/kind chart-release

@poiana poiana added the kind/chart-release Add this label when the chart version has been bumped label Jul 28, 2022
@Lowaiz Lowaiz force-pushed the feat/sidekick/helm-docs branch from 77c0005 to d77f355 Compare July 28, 2022 10:28
@Issif
Copy link
Member

Issif commented Jul 28, 2022

Amazing, seems good to me, are you ready for an approval?

@Lowaiz Lowaiz force-pushed the feat/sidekick/helm-docs branch 2 times, most recently from 4bc406b to d354f97 Compare July 28, 2022 10:34
falcosidekick/README.md Outdated Show resolved Hide resolved
falcosidekick/README.gotmpl Outdated Show resolved Hide resolved
@Lowaiz Lowaiz force-pushed the feat/sidekick/helm-docs branch from d354f97 to 9a1ad2e Compare July 28, 2022 10:58
@alacuku
Copy link
Member

alacuku commented Jul 28, 2022

Hey @Lowaiz, nice job!

Just a comment about the go template file. Having the README.md file generated using the go template file adds an extra step when we need just to update the docs. We first need to modify the content in README.gotmpl file, generate the README.md file and only then we can render and check the format of our docs. I would avoid this extra step by just generating the values table in separated file that is accessible from the README.md file. What do you think?

@Lowaiz
Copy link
Contributor Author

Lowaiz commented Jul 28, 2022

As I use a lot of helm chart, I always prefer a README including values rather than an redirection. Furthermore, there is already one redirection from the root to each chart, so I really prefer to not add one for the user.

Having values in the README, force, a bit, the user to read these values, make them a bit more accessible and probably avoid the users to miss some information.
I guess this is a personal preference, but having a extra step to render the README is a better option, IMHO, than isolate the values in an extra file.

@Lowaiz
Copy link
Contributor Author

Lowaiz commented Jul 29, 2022

Amazing, seems good to me, are you ready for an approval?

Ready when you are !

@Issif
Copy link
Member

Issif commented Jul 29, 2022

As I use a lot of helm chart, I always prefer a README including values rather than an redirection. Furthermore, there is already one redirection from the root to each chart, so I really prefer to not add one for the user.

Having values in the README, force, a bit, the user to read these values, make them a bit more accessible and probably avoid the users to miss some information. I guess this is a personal preference, but having a extra step to render the README is a better option, IMHO, than isolate the values in an extra file.

I'm adding the READMEs are imported by https://artifacthub.io/packages/helm/falcosecurity/falcosidekick, so it's a good practice to have all values there

Copy link
Member

@Issif Issif left a comment

Choose a reason for hiding this comment

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

amazing 👍
thank you

@poiana
Copy link
Contributor

poiana commented Jul 29, 2022

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Issif, Lowaiz

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@poiana
Copy link
Contributor

poiana commented Jul 29, 2022

LGTM label has been added.

Git tree hash: 3ac59d5d8764ad937260e7b7bf7e316f3610bf0c

@poiana poiana merged commit ab16380 into falcosecurity:master Jul 29, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved area/falcosidekick-chart dco-signoff: yes kind/chart-release Add this label when the chart version has been bumped kind/documentation Improvements or additions to documentation lgtm size/XXL
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants