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

Doc Update #114

Merged
merged 3 commits into from
Apr 26, 2021
Merged

Doc Update #114

merged 3 commits into from
Apr 26, 2021

Conversation

JustinKuli
Copy link
Contributor

To help new users/contributors get up to speed on this component, I think an example YAML and some description of what each field does would be very helpful. Additionally, the requirements around contributing are more clear in the community's template, so I've pulled that information into this repo.

@ycao56, I hadn't noticed your PR #111 when I made this, there is definitely overlap in our changes, sorry.

Regarding some of the fields in the table, I noticed (and tested) that the specific options for remediationAction and complianceType are not enforced by the controller. Arbitrary values can be input into those fields and the spec is not rejected: it just leads to (possibly) unexpected behavior. Similarly, most of the fields are not strictly "required", but without filling them in the behavior of the controller is not obvious without looking at the code and trying it out.

This will help unify the style across the repositories. In particular,
the language around the DCO requirement and who can submit PRs.

The community template is at:
https://github.com/open-cluster-management/community/blob/main/common_repo_templates/CONTRIBUTING_template.md

Signed-off-by: Justin Kulikauskas <justin.kulikauskas@gmail.com>
@openshift-ci-robot
Copy link

Hi @JustinKuli. Thanks for your PR.

I'm waiting for a open-cluster-management member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@JustinKuli
Copy link
Contributor Author

/cc @ycao56
/cc @dhaiducek

README.md Outdated Show resolved Hide resolved
The content and format here is based off of the great example of the
cert-policy-controller. The example is from the `policy-pod` in the
policy-collection.

The fields are from configurationpolicy_types.go, and I marked them as
required or optional depending on if they seemed necessary for the
policy to work as expected; most of them had `omitempty` in their go
struct tags, so they aren't *technically* required.

Signed-off-by: Justin Kulikauskas <justin.kulikauskas@gmail.com>
README.md Show resolved Hide resolved
@ycao56
Copy link

ycao56 commented Apr 22, 2021

can you reorg the README according to latest template in https://github.com/open-cluster-management/community/blob/main/common_repo_templates/README_template.md?

The community template can be found here:
https://github.com/open-cluster-management/community/blob/main/common_repo_templates/README_template.md

Signed-off-by: Justin Kulikauskas <justin.kulikauskas@gmail.com>
@ycao56
Copy link

ycao56 commented Apr 23, 2021

/ok-to-test

@sonarcloud
Copy link

sonarcloud bot commented Apr 23, 2021

Kudos, SonarCloud Quality Gate passed!

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

@ycao56
Copy link

ycao56 commented Apr 26, 2021

/approve

@ycao56
Copy link

ycao56 commented Apr 26, 2021

/lgtm

@openshift-ci-robot
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: JustinKuli, ycao56

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

@sonarcloud
Copy link

sonarcloud bot commented Apr 26, 2021

Kudos, SonarCloud Quality Gate passed!

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

@openshift-merge-robot openshift-merge-robot merged commit 3f13ae7 into stolostron:main Apr 26, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants