From 3593dd54c948e97f9c853daeb98e674f1e113ebf Mon Sep 17 00:00:00 2001
From: Clebert Suconic <clebertsuconic@apache.org>
Date: Tue, 8 Sep 2015 15:45:32 -0400
Subject: [PATCH] chapter about staging maven and validating releases

---
 docs/hacking-guide/en/SUMMARY.md             |  1 +
 docs/hacking-guide/en/validating-releases.md | 69 ++++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 docs/hacking-guide/en/validating-releases.md

diff --git a/docs/hacking-guide/en/SUMMARY.md b/docs/hacking-guide/en/SUMMARY.md
index d9c7a05499e..2c8038f0ebb 100644
--- a/docs/hacking-guide/en/SUMMARY.md
+++ b/docs/hacking-guide/en/SUMMARY.md
@@ -6,5 +6,6 @@
 * [Building](building.md)
 * [Tests](tests.md)
 * [Code Formatting](formatting.md)
+* [Validating releases](validating-releases.md)
 * [Notes for Maintainers](maintainers.md)
 
diff --git a/docs/hacking-guide/en/validating-releases.md b/docs/hacking-guide/en/validating-releases.md
new file mode 100644
index 00000000000..bb5b665f8bc
--- /dev/null
+++ b/docs/hacking-guide/en/validating-releases.md
@@ -0,0 +1,69 @@
+# Validating releases
+
+## Setting up the maven repository
+
+When a release is proposed a maven repository is staged.
+
+This information here was extracted from [Guide to Testing Staged Releases](https://maven.apache.org/guides/development/guide-testing-releases.html)
+
+For examples, the 1.1.0 release had the Maven Repository statged as [https://repository.apache.org/content/repositories/orgapacheactivemq-1066](https://repository.apache.org/content/repositories/orgapacheactivemq-1066).
+
+The first thing you need to do is to be able to use this release. The easiest way we have found is to change your maven settings at ``~/.m2/settings.xml``, setting up the staged repo.
+
+
+*file ~/.m2/settings.xml:*
+
+```xml
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<settings>
+   <profiles>
+      <profile>
+         <id>apache-artemis-test</id>
+         <repositories>
+
+            <repository>
+               <id>artemis-test</id>
+               <name>Apache Artemis Test</name>
+               <url>https://repository.apache.org/content/repositories/orgapacheactivemq-1066</url>
+               <layout>default</layout>
+               <releases>
+                  <enabled>true</enabled>
+               </releases>
+               <snapshots>
+                  <enabled>true</enabled>
+               </snapshots>
+            </repository>
+         </repositories>
+
+         <pluginRepositories>
+
+            <pluginRepository>
+               <id>artemis-test2</id>
+               <name>Apache Artemis Test</name>
+               <url>https://repository.apache.org/content/repositories/orgapacheactivemq-1066</url>
+               <releases>
+                  <enabled>true</enabled>
+               </releases>
+               <snapshots>
+                  <enabled>true</enabled>
+               </snapshots>
+            </pluginRepository>
+         </pluginRepositories>
+      </profile>
+   </profiles>
+
+   <activeProfiles>
+      <activeProfile>apache-artemis-test</activeProfile>
+   </activeProfiles>
+</settings>
+```
+
+After you configure this, all the maven objects will be available to your builds.
+
+
+## Using the examples
+
+The Apache ActiveMQ Artemis examples will create servers and use most of the maven components as real application were supposed to do.
+You can do this by running these examples after the .m2 profile installations for the staged repository.
+
+Of course you can use your own applications after you have staged the maven repository.