src/main/asciidoc/_chapters/community.adoc

   1 ////
   2 /**
   3  *
   4  * Licensed to the Apache Software Foundation (ASF) under one
   5  * or more contributor license agreements.  See the NOTICE file
   6  * distributed with this work for additional information
   7  * regarding copyright ownership.  The ASF licenses this file
   8  * to you under the Apache License, Version 2.0 (the
   9  * "License"); you may not use this file except in compliance
  10  * with the License.  You may obtain a copy of the License at
  11  *
  12  *     http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  */
  20 ////
  21
  22 [[community]]
  23 = Community
  24 :doctype: book
  25 :numbered:
  26 :toc: left
  27 :icons: font
  28 :experimental:
  29
  30 == Decisions
  31
  32 .Feature Branches
  33
  34 Feature Branches are easy to make.
  35 You do not have to be a committer to make one.
  36 Just request the name of your branch be added to JIRA up on the developer's mailing list and a committer will add it for you.
  37 Thereafter you can file issues against your feature branch in Apache HBase JIRA.
  38 Your code you keep elsewhere -- it should be public so it can be observed -- and you can update dev mailing list on progress.
  39 When the feature is ready for commit, 3 +1s from committers will get your feature merged.
  40 See link:https://lists.apache.org/thread.html/200513c7e7e4df23c8b9134eeee009d61205c79314e77f222d396006%401346870308%40%3Cdev.hbase.apache.org%3E[HBase, mail # dev - Thoughts
  41               about large feature dev branches]
  42
  43 [[hbase.fix.version.in.jira]]
  44 .How to set fix version in JIRA on issue resolve
  45
  46 Here is how we agreed to set versions in JIRA when we
  47 resolve an issue. If master is going to be 3.0.0, branch-2 will be 2.4.0, and branch-1 will be
  48 1.7.0 then:
  49
  50 * Commit only to master (i.e., backward-incompatible new feature): Mark with 3.0.0
  51 * Commit only to master and branch-2 (i.e., backward-compatible new feature, applicable only to
  52   2.x+): Mark with 3.0.0 and 2.4.0
  53 * Commit to master, branch-2, and branch-1 (i.e., backward-compatible new feature, applicable
  54   everywhere): Mark with 3.0.0, 2.4.0, and 1.7.0
  55 * Commit to master, branch-2, and branch-2.3, branch-1, branch-1.4 (i.e., bug fix
  56   applicable to all active release lines): Mark with 3.0.0, 2.4.0, 2.3.x, 1.7.0, and 1.4.x
  57 * Commit a fix to the website: no version
  58
  59 [[hbase.when.to.close.jira]]
  60 .Policy on when to set a RESOLVED JIRA as CLOSED
  61
  62 We agreed that for issues that list multiple releases in their _Fix Version/s_ field, CLOSE the issue on the release of any of the versions listed; subsequent change to the issue must happen in a new JIRA.
  63
  64 [[no.permanent.state.in.zk]]
  65 .Only transient state in ZooKeeper!
  66
  67 You should be able to kill the data in zookeeper and hbase should ride over it recreating the zk content as it goes.
  68 This is an old adage around these parts.
  69 We just made note of it now.
  70 We also are currently in violation of this basic tenet -- replication at least keeps permanent state in zk -- but we are working to undo this breaking of a golden rule.
  71
  72 [[community.roles]]
  73 == Community Roles
  74
  75 === Release Managers
  76
  77 Each maintained release branch has a release manager, who volunteers to coordinate new features and bug fixes are backported to that release.
  78 The release managers are link:https://hbase.apache.org/team-list.html[committers].
  79 If you would like your feature or bug fix to be included in a given release, communicate with that release manager.
  80 If this list goes out of date or you can't reach the listed person, reach out to someone else on the list.
  81
  82 NOTE: End-of-life releases are not included in this list.
  83
  84 .Release Managers
  85 [cols="1,1", options="header"]
  86 |===
  87 | Release
  88 | Release Manager
  89
  90 | 1.7
  91 | Reid Chan
  92
  93 | 2.3
  94 | Nick Dimiduk
  95
  96 | 2.4
  97 | Andrew Purtell
  98
  99 |===
 100
 101 [[hbase.commit.msg.format]]
 102 == Commit Message format
 103
 104 We agreed to the following Git commit message format:
 105 [source]
 106 ----
 107 HBASE-xxxxx <title>. (<contributor>)
 108 ----
 109 If the person making the commit is the contributor, leave off the '(<contributor>)' element.