# 前言

> 贡献者：[xixici](https://github.com/xixici)

此处为[HBase](https://hbase.apache.org/)版本的官方参考指南。


从这里，你不仅能找到发布的 HBase 版本的最终文档，而且包括相关[Javadoc](https://hbase.apache.org/apidocs/index.html)和[JIRA](https://issues.apache.org/jira/browse/HBASE)信息。 

## 关于指南

本指南仍在编辑当中。本指南的源码可以在文件夹 _src/main/asciidoc 当中找到。本指南最终使用 [AsciiDoc](http://asciidoc.org/) 构建，成为'站点'的一部分. 

运行

```
mvn site
```

来生成此文档。并且欢迎对此进行修改和改进。点击[此链接](https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310753&issuetype=1&components=12312132&summary=SHORT+DESCRIPTION) 提供 bug 反馈.

## 文档贡献

有关 AsciiDoc 的概述以及文档参与的建议，请参阅本文档后面的[相关部分](#appendix_contributing_to_documentation)。

如果这是你第一次涉足分布式计算领域......

若这是你第一次踏入分布式计算的精彩世界，你会感到这是一个有趣的年代。分布式计算是很难的，做一个分布式系统需要很多软硬件和网络的技能。

你的集群可以会因为各式各样的错误发生故障。比如 HBase 本身的 Bug,错误的配置(包括操作系统)，硬件的故障(网卡和磁盘甚至内存)（Issue 里有两个最近的硬件问题示例，表现为“HBase 很慢”） 如果你一直在写单机程序的话，你需要重新开始学习。这是一个很好的起点[分布式计算的谬论](http://en.wikipedia.org/wiki/Fallacies_of_Distributed_Computing).

所以，欢迎你。
这是一个有趣的地方。
HBase 社区。


# 报告 bugs

请使用 [JIRA]（https://issues.apache.org/jira/browse/hbase） 报告与安全无关的错误。


为了保护现有 HBase 安装免受新漏洞的影响，**请勿**使用 JIRA 报告与安全相关的错误。 相反，请将您的报告发送到邮件列表[private@hbase.apache.org]（mailto：private@hbase.apache.org），该列表允许任何人发送邮件，但限制谁可以阅读邮件。 该列表中的某个人将与您联系以跟进您的报告。

## 支持和测试

以下短语/支持/，/不支持/，/测试/，和/未测试/经常出现在本指南中。 为方便起见，这里先简要解释了这些短语在 HBase 背景下的含义

>许多 Hadoop 供应商都提供 Apache HBase 的商业版本的技术支持。 但这不是在 Apache HBase 项目中/ 支持 /的意义。 Apache HBase 团队对您的 HBase 集群，配置或数据不承担任何责任。

### 支持

在 Apache HBase 中，/ 支持 /意味着 HBase 被设计为以所描述的方式工作，并且应该将与定义的行为或功能的偏差报告为错误。

### 不支持


在 Apache HBase 中，/不支持/意味着用例或使用模式不会重视，应该被视为反模式。如果您认为应该针对给定功能或使用模式重新考虑，请提交 JIRA 或通过邮件讨论。


### 已测试

在 Apache HBase 中，/ 已测试 /意味着单元或集成测试涵盖了一个功能，并且已经证明可以按预期工作。

### 未测试

在 Apache HBase 中，/未测试/表示功能或使用模式可能或可能不以给定方式工作，并且可能会也可能不会损坏您的数据或导致操作问题。这是未知的，没有任何保证。如果您可以提供指定为/未经测试/的功能以特定方式工作的证据，请提交测试和指标，以便其他用户可以确定使用有关功能或使用模式。