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:http://search-hadoop.com/m/asM982C5FkS1[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 link:http://search-hadoop.com/m/azemIi5RCJ1[we agreed] to set versions in JIRA when we resolve an issue.
  47 If master is going to be 2.0.0, and branch-1 1.4.0 then:
  48
  49 * Commit only to master: Mark with 2.0.0
  50 * Commit to branch-1 and master: Mark with 2.0.0, and 1.4.0
  51 * Commit to branch-1.3, branch-1, and master: Mark with 2.0.0, 1.4.0, and 1.3.x
  52 * Commit site fixes: no version
  53
  54 [[hbase.when.to.close.jira]]
  55 .Policy on when to set a RESOLVED JIRA as CLOSED
  56
  57 We link:http://search-hadoop.com/m/4cIKs1iwXMS1[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.
  58
  59 [[no.permanent.state.in.zk]]
  60 .Only transient state in ZooKeeper!
  61
  62 You should be able to kill the data in zookeeper and hbase should ride over it recreating the zk content as it goes.
  63 This is an old adage around these parts.
  64 We just made note of it now.
  65 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.
  66
  67 [[community.roles]]
  68 == Community Roles
  69
  70 === Release Managers
  71
  72 Each maintained release branch has a release manager, who volunteers to coordinate new features and bug fixes are backported to that release.
  73 The release managers are link:https://hbase.apache.org/team-list.html[committers].
  74 If you would like your feature or bug fix to be included in a given release, communicate with that release manager.
  75 If this list goes out of date or you can't reach the listed person, reach out to someone else on the list.
  76
  77 NOTE: End-of-life releases are not included in this list.
  78
  79 .Release Managers
  80 [cols="1,1", options="header"]
  81 |===
  82 | Release
  83 | Release Manager
  84
  85 | 1.2
  86 | Sean Busbey
  87
  88 | 1.3
  89 | Mikhail Antonov
  90
  91 | 1.4
  92 | Andrew Purtell
  93
  94 | 2.0
  95 | Michael Stack
  96
  97 | 2.1
  98 | Duo Zhang
  99
 100 | 2.2
 101 | Guanghao Zhang
 102
 103 |===
 104
 105 [[hbase.commit.msg.format]]
 106 == Commit Message format
 107
 108 We link:http://search-hadoop.com/m/Gwxwl10cFHa1[agreed] to the following Git commit message format:
 109 [source]
 110 ----
 111 HBASE-xxxxx <title>. (<contributor>)
 112 ----
 113 If the person making the commit is the contributor, leave off the '(<contributor>)' element.