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