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

new(docs): dedicated rules contributing guide -> rules maturity definitions and rules acceptance criteria #115

Merged

Conversation

incertum
Copy link
Contributor

What type of PR is this?

Uncomment one (or more) /kind <> lines:

/kind bug

/kind cleanup

/kind design

/kind documentation

/kind failing-test

/kind feature

Any specific area of the project related to this PR?

Uncomment one (or more) /area <> lines:

/area rules

/area registry

/area build

/area documentation

What this PR does / why we need it:

Addressing

  • Rules Maturity Definitions -> rules repo
  • CONTRIBUTING -> enforce style guide and maturity framework, rules repo

from falcosecurity/falco-website#1009

@LucaGuerra please take it away and directly push to this branch.
We could also update the PR template with the new links and checklist in this PR or open a new PR afterwards.

Which issue(s) this PR fixes:

Fixes #

Special notes for your reviewer:

@poiana poiana added kind/documentation Improvements or additions to documentation dco-signoff: yes labels Jul 26, 2023
@poiana poiana requested a review from Kaizhe July 26, 2023 05:29
@poiana poiana requested a review from leodido July 26, 2023 05:29
Copy link
Member

@leogr leogr left a comment

Choose a reason for hiding this comment

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

This is awesome 🤩 Thank you 🙏

Just left two minor suggestions, otherwise it already looks fantastic 👍

CONTRIBUTING.md Outdated

The rules maturity framework was introduced based on this [proposal](proposals/20230605-rules-adoption-management-maturity-framework.md). As specified in the tags section of the [Style Guide of Falco Rules](https://falco.org/docs/rules/style-guide/#tags), every rule upstreamed to The Falco Project must include a maturity level as its first tag.

A new rule typically starts as `maturity_sandbo` and, in some cases, as `maturity_incubating`. However, it cannot immediately be at the `maturity_stable` level.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
A new rule typically starts as `maturity_sandbo` and, in some cases, as `maturity_incubating`. However, it cannot immediately be at the `maturity_stable` level.
A new rule typically starts as `maturity_sandbox` and, in some cases, as `maturity_incubating`. However, it cannot immediately be at the `maturity_stable` level.

CONTRIBUTING.md Outdated

## Maturity Levels

The levels (the maturity tag must be the first Falco tag):
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
The levels (the maturity tag must be the first Falco tag):
The levels (the maturity tag must be the first one in the rule's `tags` array):

incertum and others added 2 commits July 26, 2023 08:04
@poiana
Copy link

poiana commented Jul 26, 2023

LGTM label has been added.

Git tree hash: b98c78493508e343aa630d8acc2367cbff9de5de

@poiana
Copy link

poiana commented Jul 26, 2023

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: incertum, leogr

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 poiana merged commit 5bf679d into falcosecurity:main Jul 26, 2023
5 checks passed
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.

3 participants