blob: e2b4156ecfdac3869c7b13a6a25954ed5e76ca8c [file] [log] [blame] [view]
Kristina Chodorow974b2082015-03-31 14:49:30 +00001---
Damien Martin-Guillerez95a54b92016-07-28 12:47:11 +00002layout: contribute
3title: Governance
Kristina Chodorow974b2082015-03-31 14:49:30 +00004---
Damien Martin-Guillerez95a54b92016-07-28 12:47:11 +00005
6# Governance
7
8The Bazel project is led by a core group of contributors, initially Googlers, and managed by the
9community. The group of core contributors is self-managing - core contributors are added by two
10supporting votes from core contributors on the mailing list and no veto within four business days.
11We expect that new contributors will submit a number of patches before they become core
12contributors.
13
14## Accepting Contributions
15
16Please also see our [contribution guidelines](contributing.html).
17
18### Policy
19
20We use the following rules for accepting code contributions. This is written from the perspective
21that there is a group of people who cooperatively support the project (the *core contributors*). In
22contrast, external contributors are not actively supporting the project, but just contributing
23individual changes. At this time, all core contributors work for Google (see below for the full
24list), but this will hopefully change over time.
25
261. We require all contributors to sign [Google's Contributor License
27 Agreement](https://cla.developers.google.com/).
28
292. We accept well-written, well-tested contributions of rules written in
30 [Skylark](docs/skylark/concepts.html), in a `contrib/` directory or similar with clearly documented
31 support policies.
32
333. We accept well-written, well-tested bug fixes to built-in rules.
34
354. We accept well-written, well-tested feature contributions if a core contributor assumes support
36 responsibilities, i.e., readily answers support questions and works on bugs. This includes
37 feature contributions from external contributors. If there is no core contributor to support a
38 feature, then we will deprecate and subsequently delete the feature - we will give three months'
39 notice in such cases.
40
415. We will not accept untested changes, except in very rare cases.
42
436. We require a pre-commit code review from a core contributor for all changes. For the time being,
44 we will have to continue making changes across the internal and external code bases, which will
45 be reviewed internal to Google.
46
477. We will roll back changes if they break the internal development processes of any of the core
48 contributors.
49
508. We will move towards an open governance model where multiple parties have commit access,
51 roll-back rights, and can provide explicit support for features or rules.
52
539. We will work with interested parties to improve existing extension points and to establish new
54 extension points if they do not run counter to the internal requirements of any of the core
55 contributors.
56
57## Are you done open sourcing Bazel?
58
59Open sourcing Bazel is a work-in-progress. In particular, we're still working on open sourcing:
60
61* Many of our unit and integration tests (which should make contributing patches easier).
62* Full IDE integration.
63
64Beyond code, we'd like to eventually have all code reviews, bug tracking, and design decisions
65happen publicly, with the Bazel community involved. We are not there yet, so some changes will
66simply appear in the Bazel repository without clear explanation. Despite this lack of
67transparency, we want to support external developers and collaborate. Thus, we are opening up the
68code, even though some of the development is still happening internal to Google. Please let us know
69if anything seems unclear or unjustified as we transition to an open model.
70
71## Are there parts of Bazel that will never be open sourced?
72
73Yes, some of the code base either integrates with Google-specific technology or we have been looking
74for an excuse to get rid of (or is some combination of the two). These parts of the code base are
75not available on GitHub and probably never will be.
76
77### Core Contributors
78
79<p class="lead">
Damien Martin-Guillereze2e61a32016-11-22 16:21:45 +000080Contact the core team at <a href="mailto:bazel-core@googlegroups.com">
81bazel-core@googlegroups.com</a>.
Damien Martin-Guillerez95a54b92016-07-28 12:47:11 +000082</p>