summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKubernetes Prow Robot <k8s-ci-robot@users.noreply.github.com>2021-08-20 14:30:48 -0700
committerGitHub <noreply@github.com>2021-08-20 14:30:48 -0700
commiteb85dc5406b7c0ae662f84d8b2f54bbdfec38c27 (patch)
treee203b5f8ef62693aa2af5095e67944fcf89e4fd3
parent552d6fd6e79a5a56ced7228a619623e4ec72ac75 (diff)
parent47a20fdcd34a5ded686ebea62a66bf90dcbccd5f (diff)
Merge pull request #5848 from pravarag/add-contributing-for-sig-auth
Add CONTRIBUTING.md under SIG Auth
-rw-r--r--sig-auth/CONTRIBUTING.md65
1 files changed, 65 insertions, 0 deletions
diff --git a/sig-auth/CONTRIBUTING.md b/sig-auth/CONTRIBUTING.md
new file mode 100644
index 00000000..cc6d7349
--- /dev/null
+++ b/sig-auth/CONTRIBUTING.md
@@ -0,0 +1,65 @@
+# Contributing to SIG Auth
+
+Welcome to contributing to SIG Auth.
+
+If you haven't seen them already, the Kubernetes project has:
+
+- A [Contributor Guide](http://git.k8s.io/community/contributors/guide) - some
+ [kubernetes/kubernetes]-specific content, but lots of info for the
+ entire project
+- A [Contributor Cheat
+ Sheet](https://github.com/kubernetes/community/blob/master/contributors/guide/contributor-cheatsheet) -
+ lots of resources and handy links
+
+SIG Auth has multiple areas you can contribute to. Those contributions
+can be in the form of code, documentation, support being involved in
+mailing list discussions, attending meetings, and more. This guide
+describes different major functional areas SIG Auth is involved in,
+provides an overview of the areas, and gives pointers on getting more
+involved in each area. Consider this a launching point or the start of
+a [choose your own
+adventure](https://en.wikipedia.org/wiki/Choose_Your_Own_Adventure)
+for SIG Auth.
+
+## Workflow
+
+Just like rest of the Kubernetes project, we also use the same PR and
+review based workflow. Which means [use of the CNCF
+CLA](https://github.com/kubernetes/community/blob/master/CLA.md),
+[code review by reviewers and approvers listed in OWNERS
+files](https://github.com/kubernetes/community/blob/master/contributors/guide/owners.md),
+and tests that automatically exercise code or enforce conventions.
+
+## Issue Triaging
+
+Issues are ideally labeled with:
+
+- milestone: during which release cycle do we plan on working on this issue
+- `sig/foo`: which SIG owns this work
+- `area/foo`: which subproject or code is this issue related to
+- `kind/foo`: which kind of work is this issue describing
+- `priority/foo`: how important is this issue
+
+For example, an issue related to cleaning up and consolidating
+(`kind/cleanup`) release-related (`sig/release`) jobs and dashboards
+(`area/config`) for the v1.16 cycle (`milestone: v1.16`) that may not
+get completed by the end of the cycle if more important or more urgent
+work arises (`priority/important-longterm`).
+
+We try to have a non-stale pool of issues that are available for new
+contributors who want to help out but aren't sure what to work on or where to
+get started:
+
+- [`label:"good first issue"`][good-first-issue] - triaged per
+ [good-first-issue](https://github.com/issues?q=repo%3Akubernetes%2Fkubernetes+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+label%3A%22sig%2Fauth%22)
+- [good-first-issue-docs](https://git.k8s.io/community/contributors/guide/help-wanted.md#good-first-issue)
+- [`label:"help wanted"`][help-wanted] - triaged per
+ [help-wanted](https://github.com/issues?q=repo%3Akubernetes%2Fkubernetes+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22++label%3A%22sig%2Fauth%22)
+- [help-wanted-docs](https://git.k8s.io/community/contributors/guide/help-wanted.md#help-wanted)
+
+## Guides
+
+If you're not sure where to contribute or what any of these mean,
+please see
+[README.md](https://github.com/kubernetes/community/blob/master/README.md)
+for a brief description of the various codebases in this repo.