http://git-wip-us.apache.org/repos/asf/hadoop/blob/6cf023f9/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/CHANGES.3.1.0.md
--
diff --git
a/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/CHANGES.3.1.0.md
b/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/CHANGES.3.1.0.md
new file mode 100644
index 000..3ccbae4
--- /dev/null
+++
b/hadoop-common-project/hadoop-common/src/site/markdown/release/3.1.0/CHANGES.3.1.0.md
@@ -0,0 +1,1022 @@
+
+
+# Apache Hadoop Changelog
+
+## Release 3.1.0 - 2018-03-30
+
+### INCOMPATIBLE CHANGES:
+
+| JIRA | Summary | Priority | Component | Reporter | Contributor |
+|: |: | :--- |: |: |: |
+| [HADOOP-15008](https://issues.apache.org/jira/browse/HADOOP-15008) | Metrics
sinks may emit too frequently if multiple sink periods are configured | Minor
| metrics | Erik Krogen | Erik Krogen |
+| [HDFS-12825](https://issues.apache.org/jira/browse/HDFS-12825) | Fsck report
shows config key name for min replication issues | Minor | hdfs | Harshakiran
Reddy | Gabor Bota |
+| [HDFS-12883](https://issues.apache.org/jira/browse/HDFS-12883) | RBF:
Document Router and State Store metrics | Major | documentation | Yiqun Lin |
Yiqun Lin |
+| [HDFS-12895](https://issues.apache.org/jira/browse/HDFS-12895) | RBF: Add
ACL support for mount table | Major | . | Yiqun Lin | Yiqun Lin |
+| [YARN-7190](https://issues.apache.org/jira/browse/YARN-7190) | Ensure only
NM classpath in 2.x gets TSv2 related hbase jars, not the user classpath |
Major | timelineclient, timelinereader, timelineserver | Vrushali C | Varun
Saxena |
+| [HADOOP-13282](https://issues.apache.org/jira/browse/HADOOP-13282) | S3 blob
etags to be made visible in S3A status/getFileChecksum() calls | Minor | fs/s3
| Steve Loughran | Steve Loughran |
+| [HDFS-13099](https://issues.apache.org/jira/browse/HDFS-13099) | RBF: Use
the ZooKeeper as the default State Store | Minor | documentation | Yiqun Lin |
Yiqun Lin |
+| [YARN-7677](https://issues.apache.org/jira/browse/YARN-7677) | Docker image
cannot set HADOOP\_CONF\_DIR | Major | . | Eric Badger | Jim Brennan |
+
+
+### IMPORTANT ISSUES:
+
+| JIRA | Summary | Priority | Component | Reporter | Contributor |
+|: |: | :--- |: |: |: |
+| [HDFS-13083](https://issues.apache.org/jira/browse/HDFS-13083) | RBF: Fix
doc error setting up client | Major | federation | tartarus | tartarus |
+
+
+### NEW FEATURES:
+
+| JIRA | Summary | Priority | Component | Reporter | Contributor |
+|: |: | :--- |: |: |: |
+| [HADOOP-15005](https://issues.apache.org/jira/browse/HADOOP-15005) | Support
meta tag element in Hadoop XML configurations | Major | . | Ajay Kumar | Ajay
Kumar |
+| [YARN-3926](https://issues.apache.org/jira/browse/YARN-3926) | [Umbrella]
Extend the YARN resource model for easier resource-type management and profiles
| Major | nodemanager, resourcemanager | Varun Vasudev | Varun Vasudev |
+| [HDFS-7877](https://issues.apache.org/jira/browse/HDFS-7877) | [Umbrella]
Support maintenance state for datanodes | Major | datanode, namenode | Ming Ma
| Ming Ma |
+| [HADOOP-13055](https://issues.apache.org/jira/browse/HADOOP-13055) |
Implement linkMergeSlash and linkFallback for ViewFileSystem | Major | fs,
viewfs | Zhe Zhang | Manoj Govindassamy |
+| [YARN-6871](https://issues.apache.org/jira/browse/YARN-6871) | Add
additional deSelects params in RMWebServices#getAppReport | Major |
resourcemanager, router | Giovanni Matteo Fumarola | Tanuj Nayak |
+| [HADOOP-14840](https://issues.apache.org/jira/browse/HADOOP-14840) | Tool to
estimate resource requirements of an application pipeline based on prior
executions | Major | tools | Subru Krishnan | Rui Li |
+| [HDFS-206](https://issues.apache.org/jira/browse/HDFS-206) | Support for
head in FSShell | Minor | . | Olga Natkovich | Gabor Bota |
+| [YARN-5079](https://issues.apache.org/jira/browse/YARN-5079) | [Umbrella]
Native YARN framework layer for services and beyond | Major | . | Vinod Kumar
Vavilapalli | |
+| [YARN-4757](https://issues.apache.org/jira/browse/YARN-4757) | [Umbrella]
Simplified discovery of services via DNS mechanisms | Major | . | Vinod Kumar
Vavilapalli | |
+| [HADOOP-13786](https://issues.apache.org/jira/browse/HADOOP-13786) | Add S3A
committer for zero-rename commits to S3 endpoints | Major | fs/s3 | Steve
Loughran | Steve Loughran |
+| [HDFS-9806](https://issues.apache.org/jira/browse/HDFS-9806) | Allow HDFS
block replicas to be provided by an external storage system | Major | . |
Chris Douglas | |
+| [YARN-6592](https://issues.apache.org/jira/browse/YARN-6592) | [Umbrella]
Rich placement constraints in YARN | Major | . | Konstantinos Karanasos | |
+| [HDFS-12998](https://issues.apache.org/jira/browse/HDFS-12998) |
SnapshotDiff - Provide an iterator-based listing API for calculating