Merge branch 'stable-3.11' into stable-3.12
* stable-3.11:
Do not notify failures on collisions
Fixed erroneous increment of the rescheduled metric
Ensure failures are only incremented in RunnableWithMetrics
Move ProjectDeletionAction/CacheDeleteHandler PullReplicationModule
Change-Id: Idf22185207dc94bd184be6e4130e526ef16a2ca5
diff --git a/src/main/resources/Documentation/about.md b/README.md
similarity index 65%
rename from src/main/resources/Documentation/about.md
rename to README.md
index 247ff23..c7ee16a 100644
--- a/src/main/resources/Documentation/about.md
+++ b/README.md
@@ -1,25 +1,32 @@
+# Gerrit pull-replication plugin
+
This plugin can automatically mirror repositories from other systems.
Overview
--------
Typically replication should be done over SSH, with a passwordless
-public/private key pair. On a trusted network it is also possible to
+public/private key pair. On a trusted network it is also possible to
use replication over the insecure (but much faster due to no
authentication overhead or encryption) git:// protocol, by enabling
the `upload-pack` service on the receiving system, but this
-configuration is not recommended. It is also possible to specify a
-local path as replication source. This makes e.g. sense if a network
+configuration is not recommended. It is also possible to specify a
+local path as replication source. This makes sense if a network
share is mounted to which the repositories should be replicated from.
-Access
-------
+## Access
+
To be allowed to trigger pull replication a user must be a member of a
group that is granted the 'Pull Replication' capability (provided
by this plugin) or the 'Administrate Server' capability.
-Change Indexing
---------
+## Change Indexing
+
Changes will be automatically indexed upon replication.
+
+
+For more information please refer to the [docs](src/main/resources/Documentation)
+
+
