Merge "Revert "Cross-host support.""
diff --git a/src/main/resources/Documentation/rest-api-all-config-downstream.md b/src/main/resources/Documentation/rest-api-all-config-downstream.md
deleted file mode 100644
index 3eee7eb..0000000
--- a/src/main/resources/Documentation/rest-api-all-config-downstream.md
+++ /dev/null
@@ -1,33 +0,0 @@
-automerger config-downstream
-=============================
-
-NAME
-----
-all-config-downstream - Get set of all downstream branches
-
-SYNOPSIS
---------
-> GET /projects/{project-name}/branches/{branch-id}/automerger~all-config-downstream
-
-DESCRIPTION
------------
-Returns a list of branch names that are downstream, including ones more than one
-hop away.
-
-REQUEST
------------
-```
- GET /projects/{project-name}/branches/{branch-id}/automerger~all-config-downstream HTTP/1.0
-```
-
-RESPONSE
------------
-```
- HTTP/1.1 200 OK
- Content-Disposition: attachment
- Content-Type: application/json;charset=UTF-8
- )]}'
- [
- "master", "branch_two"
- ]
-```
diff --git a/src/main/resources/Documentation/rest-api-automerge-change.md b/src/main/resources/Documentation/rest-api-automerge-change.md
deleted file mode 100644
index 985d386..0000000
--- a/src/main/resources/Documentation/rest-api-automerge-change.md
+++ /dev/null
@@ -1,37 +0,0 @@
-automerger automerge-change
-=============================
-
-NAME
-----
-automerge-change - Automerge a change downstream
-
-SYNOPSIS
---------
-> POST /changes/${changeId}/revisions/${revisionId}/automerger~automerge-change
-
-DESCRIPTION
------------
-Returns an HTTP 204 if successful.
-
-OPTIONS
--------
---branch_map
-> A map of downstream branches to their merge value (false means it is skipped)
-
-REQUEST
------------
-```
- POST /changes/${changeId}/revisions/${revisionId}/automerger~automerge-change HTTP/1.0
- Content-Type application/json;charset=UTF-8
-
- {
- "master": true,
- "branch_two": false
- }
-```
-
-RESPONSE
------------
-```
- HTTP/1.1 204 No Content
-```
diff --git a/src/main/resources/Documentation/rest-api-config-downstream.md b/src/main/resources/Documentation/rest-api-config-downstream.md
deleted file mode 100644
index a7aecf5..0000000
--- a/src/main/resources/Documentation/rest-api-config-downstream.md
+++ /dev/null
@@ -1,45 +0,0 @@
-automerger config-downstream
-=============================
-
-NAME
-----
-config-downstream - Get the downstream config map
-
-SYNOPSIS
---------
-> POST /projects/{project-name}/automerger~config-downstream
-
-DESCRIPTION
------------
-Returns a map of branches that are one hop downstream to whether or not it
-should be skipped by default.
-
-OPTIONS
--------
-
---subject
-> The subject of the current change
-
-REQUEST
------------
-```
- POST /projects/{project-name}/automerger~config-downstream HTTP/1.0
- Content-Type application/json;charset=UTF-8
-
- {
- "subject": "DO NOT MERGE i am a test subject"
- }
-```
-
-RESPONSE
------------
-```
- HTTP/1.1 200 OK
- Content-Disposition: attachment
- Content-Type: application/json;charset=UTF-8
- )]}'
- {
- "master": true,
- "branch_two": false
- }
-```
diff --git a/src/main/resources/Documentation/rest-api.md b/src/main/resources/Documentation/rest-api.md
new file mode 100644
index 0000000..3b0b5b6
--- /dev/null
+++ b/src/main/resources/Documentation/rest-api.md
@@ -0,0 +1,88 @@
+Automerger - REST API
+============================
+
+This page describes the REST endpoints that are added by the automerger plugin.
+
+Please also take note of the general information on the
+[REST API](https://gerrit-review.googlesource.com/Documentation/rest-api.html).
+
+<a id="automerger-endpoints"> Automerger Endpoints
+-------------------------------------------------
+
+### <a id="config-downstream"> Config Downstream
+POST /projects/[\{project-name\}](https://gerrit-review.googlesource.com/Documentation/rest-api-projects.html#project-name)/automerger~config-downstream
+
+Returns a map of branches that are one hop downstream to whether or not it
+should be skipped by default.
+
+#### Request
+
+```
+ POST /projects/platform/test_data/automerger~config-downstream HTTP/1.0
+ Content-Type application/json;charset=UTF-8
+
+ {
+ "subject": "DO NOT MERGE i am a test subject"
+ }
+```
+
+#### Response
+
+```
+ HTTP/1.1 200 OK
+ Content-Disposition: attachment
+ Content-Type: application/json;charset=UTF-8
+ )]}'
+ {
+ "master": true,
+ "branch_two": false
+ }
+```
+
+### <a id="all-config-downstream"> All Config Downstream
+GET /projects/[\{project-name\}](https://gerrit-review.googlesource.com/Documentation/rest-api-projects.html#project-name)/branches/[\{branch-id\}](https://gerrit-review.googlesource.com/Documentation/rest-api-projects.html#branch-id)/automerger~all-config-downstream
+
+Returns a list of branch names that are downstream, including ones more than one
+hop away.
+
+#### Request
+
+```
+ GET /projects/platform/test_data/branches/test_branch_name/automerger~all-config-downstream HTTP/1.0
+```
+
+#### Response
+
+```
+ HTTP/1.1 200 OK
+ Content-Disposition: attachment
+ Content-Type: application/json;charset=UTF-8
+ )]}'
+ [
+ "master", "branch_two"
+ ]
+```
+
+### <a id="automerge-change"> Automerge Change
+POST /changes/[\{change-id\}](https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#change-id)/revisions/[\{revision-id\}](https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#revision-id)/automerger~automerge-change
+
+Automerges changes based on the given map, with merges being done with the
+strategy `-s ours` if the value in the map is false.
+
+#### Request
+
+```
+ POST /changes/Id3adb33f/revisions/1/automerger~automerge-change HTTP/1.0
+ Content-Type application/json;charset=UTF-8
+
+ {
+ "master": true,
+ "branch_two": false
+ }
+```
+
+#### Response
+
+```
+ HTTP/1.1 204 No Content
+```
\ No newline at end of file
