Make legacy API and its deprecation more prominent (#46)

* Create new page for legacy endpoints

* Add new page for legacy endpoints

* Remove header from previous page

Author: davidoliverSP2

modules/ROOT/content-nav.adoc

@@ -10,6 +10,7 @@
 ** xref:actions/commit-an-open-transaction.adoc[]
 ** xref:actions/rollback-an-open-transaction.adoc[]
 ** xref:actions/begin-and-commit-a-transaction-in-one-request.adoc[]
+** xref:actions/legacy-endpoints.adoc[]
 ** xref:actions/execute-multiple-statements.adoc[]
 ** xref:actions/include-query-statistics.adoc[]
 ** xref:actions/return-results-in-graph-format.adoc[]

modules/ROOT/pages/actions/begin-and-commit-a-transaction-in-one-request.adoc

@@ -3,8 +3,6 @@
 [[http-api-begin-and-commit-a-transaction-in-one-request]]
 = Begin and commit a transaction in one request
 
-== Begin and commit request
-
 If there is no need to keep a transaction open across multiple HTTP requests, you can begin a transaction, execute statements, and commit within a single HTTP request.
 
 _Example request_
@@ -49,55 +47,3 @@ _Example response_
   "errors" : [ ]
 }
 ----
-
-
-== Legacy Endpoints label:deprecated[]
-
-[IMPORTANT]
-====
-The API described in this section of the manual has been deprecated and will be removed in Neo4j 5.0.
-====
-
-_Example request_
-
-* *+POST+* +http://localhost:7474/db/neo4j/tx/commit+
-* *+Accept:+* +application/json;charset=UTF-8+
-* *+Content-Type:+* +application/json+
-
-[source, JSON, role="nocopy"]
-----
-{
-  "statements": [
-    {
-      "statement": "MATCH (n) WHERE id(n) = $nodeId RETURN n",
-      "parameters": {
-        "nodeId": 2
-      }
-    }
-  ]
-}
-----
-
-_Example response_
-
-* *+200:+* +OK+
-* *+Content-Type:+* +application/json;charset=utf-8+
-
-[source, JSON, role="nocopy"]
-----
-{
-  "results" : [ {
-    "columns" : [ "n" ],
-    "data" : [ {
-      "row" : [ { } ],
-      "meta" : [ {
-        "id" : 2,
-        "type" : "node",
-        "deleted" : false
-      } ]
-    } ]
-  } ],
-  "errors" : [ ]
-}
-----
-

modules/ROOT/pages/actions/index.adoc

@@ -18,6 +18,7 @@ There are several _actions_ that can be performed using the Cypher transaction H
 * xref:actions/commit-an-open-transaction.adoc[]
 * xref:actions/rollback-an-open-transaction.adoc[]
 * xref:actions/begin-and-commit-a-transaction-in-one-request.adoc[]
+* xref:actions/legacy-endpoints.adoc[]
 
 *Additional actions:*
 
@@ -30,4 +31,3 @@ There are several _actions_ that can be performed using the Cypher transaction H
 * xref:actions/expired-transactions.adoc[]
 * xref:actions/handling-errors.adoc[]
 * xref:actions/handling-errors-in-an-open-transaction.adoc[]
-

modules/ROOT/pages/actions/legacy-endpoints.adoc

@@ -0,0 +1,64 @@
+:description: Legacy endpoints.
+
+[[http-api-legacy-endpoints]]
+= [deprecated]#Legacy Endpoints#
+
+[IMPORTANT]
+====
+The API described in this section of the manual has been deprecated and will be removed in Neo4j 5.0.
+====
+
+For backwards compatibility with neo4j 3.5, it is still possible to use the HTTP API without specifying the database in the URL.
+For example:
+
+`http://localhost:7474/db/data/transaction/commit`.
+
+Since the database is not specified, the statements will be executed against the user's _global default database_.
+
+All endpoints can also be executed against the legacy API, where `db/<database-name>` is replaced with `db/data/transaction`.
+The input format and output format are identical for both the legacy API and the current API.
+
+For example, beginning and committing a transaction in a single requests looks as follows:
+
+_Example request_
+
+* *+POST+* +http://localhost:7474/db/data/transaction/commit+
+* *+Accept:+* +application/json;charset=UTF-8+
+* *+Content-Type:+* +application/json+
+
+[source, JSON, role="nocopy"]
+----
+{
+  "statements": [
+    {
+      "statement": "MATCH (n) WHERE id(n) = $nodeId RETURN n",
+      "parameters": {
+        "nodeId": 2
+      }
+    }
+  ]
+}
+----
+
+_Example response_
+
+* *+200:+* +OK+
+* *+Content-Type:+* +application/json;charset=utf-8+
+
+[source, JSON, role="nocopy"]
+----
+{
+  "results" : [ {
+    "columns" : [ "n" ],
+    "data" : [ {
+      "row" : [ { } ],
+      "meta" : [ {
+        "id" : 2,
+        "type" : "node",
+        "deleted" : false
+      } ]
+    } ]
+  } ],
+  "errors" : [ ]
+}
+----