aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorGravatar Googler <noreply@google.com>2015-03-30 12:14:18 +0000
committerGravatar Ulf Adams <ulfjack@google.com>2015-03-30 12:21:45 +0000
commit87bab7d159cb132164239b54d327e9e24f055b92 (patch)
treeedc02ff5ad237973e42642d0ec924952266c7f63
parent899a8ef7235306294c83a85b0b2d234701e2c3da (diff)
Adds line breaks for readability and better rendering by our Markdown interpreter.
-- MOS_MIGRATED_REVID=89856380
-rw-r--r--docs/governance.md13
1 files changed, 12 insertions, 1 deletions
diff --git a/docs/governance.md b/docs/governance.md
index c0279b82a7..e70a1072d3 100644
--- a/docs/governance.md
+++ b/docs/governance.md
@@ -1,6 +1,7 @@
# Governance
## Is Bazel developed fully in the open? {#isbazelopen}
+
Unfortunately not. We have a significant amount of code that is not open source, mostly rules,
unit tests and interfaces to internal Google systems. Initially we are open sourcing only ~10% of
the build rules used internally at Google. We did an experiment over the course of a few weeks
@@ -17,6 +18,7 @@ though some of the development is still happening internal to Google.
Please also see our [contribution guidelines](contributing.md).
### Policy
+
We use the following rules for accepting code contributions. This is written from the perspective
that there is a group of people who cooperatively support the project (the *core contributors*). In
contrast, external contributors are not actively supporting the project, but just contributing
@@ -25,29 +27,39 @@ list), but this will hopefully change over time.
1. We require all contributors to sign [Google's Contributor License
Agreement](https://cla.developers.google.com/).
+
2. We accept well-written, well-tested contributions of rules written in
[Skylark](skylark/concepts.md), in a `contrib/` directory or similar with clearly documented
support policies.
+
3. We accept well-written, well-tested cleanup and refactoring changes.
+
4. We accept well-written, well-tested bug fixes to built-in rules.
+
5. We accept well-written, well-tested feature contributions if a core contributor assumes support
responsibilities, i.e., readily answers support questions and works on bugs. This includes
feature contributions from external contributors. If there is no core contributor to support a
feature, then we will deprecate and subsequently delete the feature - we will give three months'
notice in such cases.
+
6. We will not accept untested changes, except in very rare cases.
+
7. We require a pre-commit code review from a core contributor for all changes. For the time being,
we will have to continue making changes across the internal and external code bases, which will
be reviewed internal to Google.
+
8. We will roll back changes if they break the internal development processes of any of the core
contributors.
+
9. We will move towards an open governance model where multiple parties have commit access,
roll-back rights, and can provide explicit support for features or rules.
+
10. We will work with interested parties to improve existing extension points and to establish new
extension points if they do not run counter to the internal requirements of any of the core
contributors.
### Core Contributors
+
The group of core contributors is self-managing - core contributors are added by two supporting
votes from core contributors on the mailing list and no veto within four business days. We expect
that new contributors will submit a number of patches before they become core contributors.
@@ -67,4 +79,3 @@ The current group is:
- `lberki`
- `philwo`
- `ulfjack`
-