clarifying SIG and asking questions
This commit is contained in:
guineveresaenger
parent
55c4f16c91
commit
0ffd43236f
|
|
@ -1,96 +0,0 @@
|
|||
|
||||
Welcome to Kubernetes! (New Developer Guide)
|
||||
============================================
|
||||
|
||||
_This document assumes that you know what Kubernetes does. If you don't, check
|
||||
out [the Kubernetes keynote](https://www.youtube.com/watch?v=8SvQqZNP6uo) and
|
||||
try the demo at [https://k8s.io/](https://k8s.io/)._
|
||||
|
||||
Introduction
|
||||
------------
|
||||
|
||||
Have you ever wanted to contribute to the coolest cloud technology? This
|
||||
document will help you understand the organization of the Kubernetes project and
|
||||
direct you to the best places to get started. By the end of this doc, you'll be
|
||||
able to pick up issues, write code to fix them, and get your work reviewed and
|
||||
merged.
|
||||
|
||||
If you have questions about the development process, feel free to jump into our
|
||||
[Slack workspace](http://slack.k8s.io/) or join our [mailing
|
||||
list](https://groups.google.com/forum/#!forum/kubernetes-dev). If you join the
|
||||
Slack workspace it is recommended to set your Slack display name to your GitHub
|
||||
account handle.
|
||||
|
||||
Special Interest Groups
|
||||
-----------------------
|
||||
|
||||
Kubernetes developers work in teams called Special Interest Groups (SIGs). At
|
||||
the time of this writing there are [31 SIGs](../../sig-list.md).
|
||||
|
||||
The developers within each SIG have autonomy and ownership over that SIG's part
|
||||
of Kubernetes. SIGs organize themselves by meeting regularly and submitting
|
||||
markdown design documents to the
|
||||
[kubernetes/community](https://github.com/kubernetes/community) repository. You
|
||||
can see an example of the design document process at
|
||||
[kubernetes/community#645](https://github.com/kubernetes/community/pull/645).
|
||||
Like everything else in Kubernetes, a SIG is an open, community, effort. Anybody
|
||||
is welcome to jump into a SIG and begin fixing issues, critiquing design
|
||||
proposals and reviewing code.
|
||||
|
||||
Most people who visit the Kubernetes repository for the first time are
|
||||
bewildered by the thousands of [open
|
||||
issues](https://github.com/kubernetes/kubernetes/issues) in our main repository.
|
||||
But now that you know about SIGs, it's easy to filter by labels to see what's
|
||||
going on in a particular SIG. For more information about our issue system, check
|
||||
out
|
||||
[issues.md](https://github.com/kubernetes/community/blob/master/contributors/devel/issues.md).
|
||||
|
||||
Downloading, Building, and Testing Kubernetes
|
||||
---------------------------------------------
|
||||
|
||||
This guide is non-technical, so it does not cover the technical details of
|
||||
working Kubernetes. We have plenty of documentation available under
|
||||
[github.com/kubernetes/community/contributors/devel](https://github.com/kubernetes/community/tree/master/contributors/devel).
|
||||
Check out
|
||||
[development.md](https://github.com/kubernetes/community/blob/master/contributors/devel/development.md)
|
||||
for more details.
|
||||
|
||||
Pull-Request Process
|
||||
--------------------
|
||||
|
||||
The pull-request process is documented in [pull-requests.md](pull-requests.md).
|
||||
As described in that document, you must sign the [CLA](../../CLA.md) before
|
||||
Kubernetes can accept your contribution.
|
||||
|
||||
There is an entire SIG
|
||||
([sig-contributor-experience](../../sig-contributor-experience/README.md))
|
||||
devoted to improving your experience as a contributor. Contributing to
|
||||
Kubernetes should be easy. If you find a rough edge, let us know! File an issue
|
||||
in the appropriate repository if you know it, send a message on [our Slack
|
||||
channel](https://kubernetes.slack.com/messages/C1TU9EB9S/details) or to the
|
||||
[owners](https://github.com/kubernetes/community/blob/master/contributors/devel/owners.md)
|
||||
of contributor-experience. Better yet, help us fix it by joining the SIG; just
|
||||
show up to one of the [bi-weekly
|
||||
meetings](https://docs.google.com/document/d/1qf-02B7EOrItQgwXFxgqZ5qjW0mtfu5qkYIF1Hl4ZLI/edit).
|
||||
|
||||
The Release Process and Code Freeze
|
||||
-----------------------------------
|
||||
|
||||
Every so often @k8s-merge-robot will refuse to merge your PR, saying something
|
||||
about release milestones. This happens when we are in a code freeze for a
|
||||
release. In order to ensure Kubernetes is stable, we stop merging everything
|
||||
that's not a bugfix, then focus on making all the release tests pass. This code
|
||||
freeze usually lasts two weeks and happens once per quarter. See the [1.8 release
|
||||
schedule](https://github.com/kubernetes/features/blob/master/release-1.8/release-1.8.md)
|
||||
for more information.
|
||||
|
||||
If you're new to Kubernetes, you won't have to worry about this too much. After
|
||||
you've contributed for a few months, you will be added as a [community
|
||||
member](https://github.com/kubernetes/community/blob/master/community-membership.md)
|
||||
and take ownership of some of the tests. At this point, you'll work with members
|
||||
of your SIG to review PRs coming into your area and track down issues that occur
|
||||
in tests.
|
||||
|
||||
Thanks for reading!
|
||||
|
||||
|
||||
|
|
@ -62,11 +62,9 @@ Many thanks in advance to everyone who contributes their time and effort to maki
|
|||
|
||||
# Your First Contribution
|
||||
|
||||
(from [here](/contributors/devel/welcome-to-kubernetes-new-developer-guide.md#introduction))
|
||||
|
||||
Have you ever wanted to contribute to the coolest cloud technology? We will help you understand the organization of the Kubernetes project and direct you to the best places to get started. You'll be able to pick up issues, write code to fix them, and get your work reviewed and merged.
|
||||
|
||||
If you have questions about the development process, feel free to jump into our [Slack Channel](http://slack.k8s.io/) or join our [mailing list](https://groups.google.com/forum/#!forum/kubernetes-dev).
|
||||
If you have questions about the development process, feel free to jump into our [Slack Channel](http://slack.k8s.io/) or join our [mailing list](https://groups.google.com/forum/#!forum/kubernetes-dev). You can also ask questions on [ServerFault](https://serverfault.com/questions/tagged/kubernetes) or [Stack Overflow](https://stackoverflow.com/questions/tagged/kubernetes). The Kubernetes team scans Stack Overflow on a regular basis, and will try to ensure your questions don't go unanswered.
|
||||
|
||||
_Improvements needed_
|
||||
* The doc linked [above](/contributors/devel/welcome-to-kubernetes-new-developer-guide.md#introduction) is being reinvented in this README. All relevant information should be ported to a logical place in this document/folder, and the original document deleted.
|
||||
|
|
@ -80,22 +78,28 @@ You get the idea - if you ever see something you think should be fixed, you shou
|
|||
|
||||
There are multiple repositories within the Kubernetes community and a full list of repositories can be found [here](https://github.com/kubernetes/).
|
||||
Each repository in the Kubernetes organization has beginner-friendly issues that provide a good first issue. For example, [kubernetes/kubernetes](https://git.k8s.io/kubernetes) has [help-wanted issues](https://issues.k8s.io/?q=is%3Aopen+is%3Aissue+label%3Ahelp-wanted) that should not need deep knowledge of the system.
|
||||
Another good strategy is to find a documentation improvement, such as a missing/broken link, which will give you exposure to the code submission/review process without the added complication of technical depth.
|
||||
Another good strategy is to find a documentation improvement, such as a missing/broken link, which will give you exposure to the code submission/review process without the added complication of technical depth. Please see [Contributing](#Contributing) below for the workflow.
|
||||
|
||||
### Find a SIG that is related to your contribution
|
||||
|
||||
You may have noticed that some repositories in the Kubernetes Organization are owned by Special Interest Groups, or SIGs. We organize the Kubernetes community into SIGs in order to improve our workflow and more easily manage what is a very large community project.
|
||||
You may have noticed that some repositories in the Kubernetes Organization are owned by Special Interest Groups, or SIGs. We organize the Kubernetes community into SIGs in order to improve our workflow and more easily manage what is a very large community project. The developers within each SIG have autonomy and ownership over that SIG's part of Kubernetes.
|
||||
SIGs also have their own CONTRIBUTING.md files, which may contain extra information or guidelines in addition to these general ones. These are located in the SIG specific community documentation directories, for example: sig-docs' is in the kubernetes/community repo's [/sig-docs/CONTRIBUTING.md](/sig-docs/CONTRIBUTING.md) file and similarly for other SIGs.
|
||||
|
||||
Like everything else in Kubernetes, a SIG is an open, community, effort. Anybody is welcome to jump into a SIG and begin fixing issues, critiquing design proposals and reviewing code. SIGs have regular [video meetings](https://kubernetes.io/community/) which everyone is welcome to.
|
||||
|
||||
There is an entire SIG ([sig-contributor-experience](../../sig-contributor-experience/README.md)) devoted to improving your experience as a contributor.
|
||||
Contributing to Kubernetes should be easy. If you find a rough edge, let us know! Better yet, help us fix it by joining the SIG; just
|
||||
show up to one of the [bi-weekly meetings](https://docs.google.com/document/d/1qf-02B7EOrItQgwXFxgqZ5qjW0mtfu5qkYIF1Hl4ZLI/edit).
|
||||
|
||||
Finding the appropriate SIG for your contribution will help you ask questions in the correct place and give your contribution higher visibility and a faster community response.
|
||||
|
||||
For Pull Requests, the automatically assigned reviewer will add a SIG label if you haven't done so. See [Open A Pull Request](#open-a-pull-request) below.
|
||||
|
||||
For Issues we are still working on a more automated workflow. Since SIGs do not directly map onto Kubernetes subrepositories, it may be difficult to find which SIG your contribution belongs in. Here is the [list of SIGs](/sig-list.md). Determine which is most likely related to your contribution.
|
||||
|
||||
*Example:* if you have a cni contribution, you should choose SIG-networking.
|
||||
*Example:* if you are filing a cni issue, you should choose SIG-networking.
|
||||
|
||||
Follow the link in the SIG name column to reach each SIGs README. Most SIGs will have a set of GitHub Teams with tags that can be mentioned on issues and pull requests for higher visibility. If you are not sure about the correct SIG for an issue, you can try SIG-contributor-experience [here](/sig-contributor-experience#github-teams).
|
||||
Follow the link in the SIG name column to reach each SIGs README. Most SIGs will have a set of GitHub Teams with tags that can be mentioned in a comment on issues and pull requests for higher visibility. If you are not sure about the correct SIG for an issue, you can try SIG-contributor-experience [here](/sig-contributor-experience#github-teams), or [ask in Slack](http://slack.k8s.io/).
|
||||
|
||||
_Improvements needed_
|
||||
|
||||
|
|
@ -103,15 +107,12 @@ _Improvements needed_
|
|||
|
||||
### File an Issue
|
||||
|
||||
Not ready to contribute code, but see something that needs work? While the community encourages everyone to contribute code, it is also appreciated when someone reports an issue (aka problem). Issues should be filed under the appropriate repository.
|
||||
Not ready to contribute code, but see something that needs work? While the community encourages everyone to contribute code, it is also appreciated when someone reports an issue (aka problem). Issues should be filed under the appropriate Kubernetes subrepository.
|
||||
|
||||
*Example:* a documentation issue should be opened to [kubernetes/website](https://github.com/kubernetes/website/issues).
|
||||
|
||||
Make sure to adhere to the prompted submission guidelines while opening an issue.
|
||||
|
||||
*A note on questions*
|
||||
Our triage team has many issues to triage. Please do not file an issue if you are learning Kubernetes and have a question. Questions should be asked on [Stack Overflow](https://stackoverflow.com/questions/tagged/kubernetes), [ServerFault](https://serverfault.com/questions/tagged/kubernetes), or on the appropriate Kubernetes [Slack Channel](http://slack.k8s.io/). We also have [Kubernetes Office Hours](/office-hours.md) once a month.
|
||||
|
||||
# Contributing
|
||||
|
||||
(From:[here](/contributors/devel/collab.md))
|
||||
|
|
@ -120,11 +121,11 @@ Kubernetes is open source, but many of the people working on it do so as their d
|
|||
|
||||
As a potential contributor, your changes and ideas are welcome at any hour of the day or night, weekdays, weekends, and holidays. Please do not ever hesitate to ask a question or send a pull request.
|
||||
|
||||
Our community guiding principles on how to create great code as a big group are found [here](/contributors/devel/collab.md). Beginner focused information can be found below in [Open a Pull Request](#open-a-pull-request) and [Code Review](#code-review).
|
||||
Our community guiding principles on how to create great code as a big group are found [here](/contributors/devel/collab.md). Beginner focused information can be found below in [Open a Pull Request](#open-a-pull-request) and [Code Review](#code-review).
|
||||
|
||||
### Communication
|
||||
|
||||
It is best to contact your SIG for issues related to the SIG's topic. Your SIG will be able to help you much more quickly than a general question would. Each SIG has a kubernetes slack channel that you can join as well.
|
||||
It is best to contact your [SIG](#find-a-sig-that-is-related-to-your-contribution) for issues related to the SIG's topic. Your SIG will be able to help you much more quickly than a general question would. Each SIG has a kubernetes slack channel that you can join as well.
|
||||
|
||||
For questions and troubleshooting, please feel free to use any of the methods of communication listed [here](/communication.md). The [kubernetes website](https://kubernetes.io/community/) also lists this information.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue