From 765ad740477d3428c22a22d17aebed51275b3720 Mon Sep 17 00:00:00 2001
From: Duo Zhang <zhangduo@apache.org>
Date: Tue, 6 Dec 2022 00:00:38 +0800
Subject: [PATCH] HBASE-27513 Modify README.txt to mention how to contribue

---
 README.md  | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.txt | 34 ----------------------------------
 2 files changed, 54 insertions(+), 34 deletions(-)
 create mode 100644 README.md
 delete mode 100755 README.txt

diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..d9bc70bb5fed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+![hbase-logo](https://raw.githubusercontent.com/apache/hbase/master/src/site/resources/images/hbase_logo_with_orca_large.png)
+
+[Apache HBase](https://hbase.apache.org) is an open-source, distributed, versioned, column-oriented store modeled after Google' [Bigtable](https://research.google.com/archive/bigtable.html): A Distributed Storage System for Structured Data by Chang et al. Just as Bigtable leverages the distributed data storage provided by the Google File System, HBase provides Bigtable-like capabilities on top of [Apache Hadoop](https://hadoop.apache.org/).
+
+# Getting start
+To get started using HBase, the full documentation for this release can be found under the doc/ directory that accompanies this README. Using a browser, open the docs/index.html to view the project home page (or browse https://hbase.apache.org). The hbase '[book](https://hbase.apache.org/book.html)' has a 'quick start' section and is where you should being your exploration of the hbase project.
+
+The latest HBase can be downloaded from the [download page](https://hbase.apache.org/downloads.html).
+
+We use mailing lists to send notice and discuss. The mailing lists and archives are listed [here](http://hbase.apache.org/mail-lists.html)
+
+# How to contribute
+The source code can be found at https://hbase.apache.org/source-repository.html
+
+The HBase issue tracker is at https://hbase.apache.org/issue-tracking.html
+
+Notice that, the public registration for https://issues.apache.org/ has been disabled due to spam. If you want to contribute to HBase, please send an email to [private@hbase.apache.org](mailto:private@hbase.apache.org) in the follow format so the HBase PMC members can acquire a jira account for you:
+
+```
+Subject: Request for Jira account
+
+Contents of the mail(should be in English):
+Preferred Jira Id:
+Full Name:
+E-Mail Address:
+
+Reason: Jira Id you wish to contribute to, or details around the bug/feature you wish to report or work on.
+```
+
+> **_NOTE:_** we need to process the requests manually so it may take sometime, for example, up to a week, for us to respond to your request.
+
+# About
+Apache HBase is made available under the [Apache License, version 2.0](https://hbase.apache.org/license.html)
+
+The HBase distribution includes cryptographic software. See the export control notice [here](https://hbase.apache.org/export_control.html).
diff --git a/README.txt b/README.txt
deleted file mode 100755
index 7a172271caf4..000000000000
--- a/README.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-Apache HBase [1] is an open-source, distributed, versioned, column-oriented
-store modeled after Google' Bigtable: A Distributed Storage System for
-Structured Data by Chang et al.[2]  Just as Bigtable leverages the distributed
-data storage provided by the Google File System, HBase provides Bigtable-like
-capabilities on top of Apache Hadoop [3].
-
-To get started using HBase, the full documentation for this release can be
-found under the doc/ directory that accompanies this README.  Using a browser,
-open the docs/index.html to view the project home page (or browse to [1]).
-The hbase 'book' at http://hbase.apache.org/book.html has a 'quick start'
-section and is where you should being your exploration of the hbase project.
-
-The latest HBase can be downloaded from an Apache Mirror [4].
-
-The source code can be found at [5]
-
-The HBase issue tracker is at [6]
-
-Apache HBase is made available under the Apache License, version 2.0 [7]
-
-The HBase mailing lists and archives are listed here [8].
-
-The HBase distribution includes cryptographic software. See the export control
-notice here [9].
-
-1. http://hbase.apache.org
-2. http://research.google.com/archive/bigtable.html
-3. http://hadoop.apache.org
-4. http://www.apache.org/dyn/closer.lua/hbase/
-5. https://hbase.apache.org/source-repository.html
-6. https://hbase.apache.org/issue-tracking.html
-7. http://hbase.apache.org/license.html
-8. http://hbase.apache.org/mail-lists.html
-9. https://hbase.apache.org/export_control.html