reorganized the page to accommodate Cypher 25 syntax

Author: renetapopova

modules/ROOT/pages/database-administration/syntax.adoc

@@ -78,7 +78,9 @@ REQUIRE n.propertyName IS NOT NULL
 [[administration-syntax-database-management]]
 == Database management command syntax
 
-The below table covers both standard and composite databases.
+The following tables cover both standard and composite databases.
+
+=== Show databases
 
 [options="header", width="100%", cols="1m,5a"]
 |===
@@ -99,12 +101,35 @@ YIELD { * \| field[, ...] } [ORDER BY field[, ...]] [SKIP n] [LIMIT n]
 [WHERE expression]
 [RETURN field[, ...] [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
 ----
+|===
+
+=== Create a database
+
+[options="header", width="100%", cols="2m,4a,4a"]
+|===
+| Command | Syntax Cypher 5 | Syntax Cypher 25
 
 | CREATE DATABASE
 |
 [source, syntax, role="noheader"]
 ----
 CREATE DATABASE name [IF NOT EXISTS]
+[TOPOLOGY n PRIMAR{Y\|IES} [m SECONDAR{Y\|IES}]]
+[OPTIONS "{" option: value[, ...] "}"]
+[WAIT [n [SEC[OND[S]]]]\|NOWAIT]
+----
+
+[source, syntax, role="noheader"]
+----
+CREATE OR REPLACE DATABASE name
+[TOPOLOGY n PRIMAR{Y\|IES} [m SECONDAR{Y\|IES}]]
+[OPTIONS "{" option: value[, ...] "}"]
+[WAIT [n [SEC[OND[S]]]]\|NOWAIT]
+----
+|
+[source, syntax, role="noheader"]
+----
+CREATE DATABASE name [IF NOT EXISTS]
 [[SET] TOPOLOGY n PRIMAR{Y\|IES} [m SECONDAR{Y\|IES}]]
 [OPTIONS "{" option: value[, ...] "}"]
 [WAIT [n [SEC[OND[S]]]]\|NOWAIT]
@@ -117,6 +142,13 @@ CREATE OR REPLACE DATABASE name
 [OPTIONS "{" option: value[, ...] "}"]
 [WAIT [n [SEC[OND[S]]]]\|NOWAIT]
 ----
+|===
+
+=== Create a composite database
+
+[options="header", width="100%", cols="2m,4a"]
+|===
+| Command | Syntax
 
 | CREATE COMPOSITE DATABASE
 |
@@ -133,6 +165,13 @@ CREATE OR REPLACE COMPOSITE DATABASE name
 [OPTIONS "{" "}"]
 [WAIT [n [SEC[OND[S]]]]\|NOWAIT]
 ----
+|===
+
+=== Alter a database
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
 | ALTER DATABASE
 |
@@ -158,21 +197,41 @@ REMOVE OPTION option
 ====
 There can be multiple `SET OPTION` or `REMOVE OPTION` clauses for different option keys.
 ====
+|===
+
+=== Stop a database
 
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
 | STOP DATABASE
 |
 [source, syntax, role="noheader"]
 ----
 STOP DATABASE name [WAIT [n [SEC[OND[S]]]]\|NOWAIT]
 ----
+|===
+
+=== Start a database
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
 | START DATABASE
 |
 [source, syntax, role="noheader"]
 ----
 START DATABASE name [WAIT [n [SEC[OND[S]]]]\|NOWAIT]
 ----
+|===
+
+=== Delete a database
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
 | DROP DATABASE
 |
@@ -186,10 +245,14 @@ DROP [COMPOSITE] DATABASE name [IF EXISTS] [RESTRICT \| CASCADE ALIAS[ES]] [{DUM
 [[administration-syntax-database-alias-management]]
 == Database alias management command syntax
 
-[options="header", width="100%", cols="1,5a"]
+The following tables cover both local and remote database aliases.
+
+=== Show aliases
+
+[options="header", width="100%", cols="1m,5a"]
 |===
 | Command | Syntax
-| Show Database Alias
+| SHOW ALIAS
 |
 [source, syntax, role=noheader]
 -----
@@ -204,8 +267,15 @@ YIELD { * \| field[, ...] } [ORDER BY field[, ...]] [SKIP n] [LIMIT n]
 [RETURN field[, ...] [ORDER BY field[, ...]] [SKIP n] [LIMIT n]]
 -----
 Lists both local and remote database aliases, optionally filtered on the alias name.
+|===
+
+=== Create a local alias
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
-| Create Local Alias
+| CREATE ALIAS
 |
 [source, syntax, role=noheader]
 -----
@@ -217,8 +287,15 @@ CREATE ALIAS name [IF NOT EXISTS] FOR DATABASE targetName
 CREATE OR REPLACE ALIAS name FOR DATABASE targetName
 [PROPERTIES "{" key: value[, ...] "}"]
 -----
+|===
+
+=== Create a remote alias
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
-| Create Remote Alias
+| CREATE ALIAS
 |
 [source, syntax, role=noheader]
 -----
@@ -234,17 +311,30 @@ AT 'url' USER username PASSWORD 'password'
 [DRIVER "{" setting: value[, ...] "}"]
 [PROPERTIES "{" key: value[, ...] "}"]
 -----
+|===
+
+=== Alter a local alias
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
 
-| Alter Local Alias
+|ALTER ALIAS
 |
 [source, syntax, role=noheader]
 -----
 ALTER ALIAS name [IF EXISTS] SET DATABASE
 [TARGET targetName]
 [PROPERTIES "{" key: value[, ...] "}"]
 -----
+|===
+
+=== Alter a remote alias
 
-| Alter Remote Alias
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
+|ALTER ALIAS
 |
 [source, syntax, role=noheader]
 -----
@@ -256,7 +346,15 @@ ALTER ALIAS name [IF EXISTS] SET DATABASE
 [PROPERTIES "{" key: value[, ...] "}"]
 -----
 
-| Drop Alias
+|===
+
+=== Delete an alias
+
+[options="header", width="100%", cols="1m,5a"]
+|===
+| Command | Syntax
+
+| DROP ALIAS
 |
 [source, syntax, role=noheader]
 -----