Update neo4j-admin server memory-recommendation syntax and options to reflect the code (#691) (#698)

Cherry-picked from #691

Author: renetapopova

modules/ROOT/pages/tools/neo4j-admin/neo4j-admin-memrec.adoc

@@ -9,57 +9,59 @@ You can use the `neo4j-admin server memory-recommendation` command to get an ini
 The `neo4j-admin server memory-recommendation` command has the following syntax:
 
 ----
-neo4j-admin server memory-recommendation [-h] 
-                                         [--docker]
-                                         [--expand-commands]
-                                         [--verbose]
-                                         [--additional-config=<file>]
+neo4j-admin server memory-recommendation [-h] [--docker] [--expand-commands]
+                                         [--verbose] [--additional-config=<file>]
                                          [--memory=<size>]
 ----
 
-The command gives heuristic memory settings recommendations for the Neo4j JVM heap and pagecache.
+=== Description
+
+The command prints heuristic memory settings recommendations for the Neo4j JVM heap and pagecache.
 It either uses the total system memory or the amount of memory specified in the `--memory` argument.
-The heuristic also assumes that the system is dedicated to running Neo4j.
-If this is not the case, then use the `--memory` argument to specify how much memory can be expected to be dedicated to Neo4j.
-The default output is formatted so you can copy and paste it into xref:configuration/file-locations.adoc[_neo4j.conf_].
+The heuristic assumes that the system is dedicated to running Neo4j.
+If this is not the case, then use the --memory argument to specify how much memory can be expected to be dedicated to Neo4j.
+The output is formatted such that it can be copy-pasted into the _neo4j.conf_ file.
+
 The argument `--docker` outputs environmental variables that can be passed to a Neo4j Docker container.
 For a detailed example, see xref:docker/operations.adoc#docker-neo4j-memrec[Use Neo4j Admin for memory recommendations].
 
-== Options
+=== Options
 
 The `neo4j-admin server memory-recommendation` command has the following options:
 
-.Options
-[options="header", cols="1a,2m,3a"]
+.`neo4j-admin server memory-recommendation` options
+[options="header", cols="5m,6a,4m"]
 |===
 | Option
-| Default 
 | Description
+| Default
 
-| `-h`, `--help`
-| 
-| Show this help message and exit.
+|--additional-config=<file>
+|Configuration file with additional configuration.
+|
 
-| `--docker`
+|--docker
+|The recommended memory settings are produced in the form of environment variables that can be
+directly passed to a Neo4j docker container. The recommended use is to save the generated
+environment variables to a file and pass the file to a docker container using `--env-file`
+docker option.
 |
-| Enable output formatted as environmental variables that can be passed to a Neo4j Docker container.
-The recommended use is to save the generated environment variables to a file and pass that file to a Docker container using `--env-file` Docker option.
 
-| `--expand-commands`
+|--expand-commands
+|Allow command expansion in config value evaluation.
 |
-| Expand the commands to be run.
 
-| `--verbose`
+|-h, --help
+|Show this help message and exit.
 |
-| Enable verbose output.
 
-| `--additional-config`
-| `<file>`
-| Configuration file to supply additional configuration in.
+|--memory=<size>
+|Recommend memory settings with respect to the given amount of memory, instead of the total memory of the system running the command. Valid units are: `k`, `K`, `m`, `M`, `g`, `G`.
+|The memory capacity of the machine.
 
-| `--memory`
-| `<size>` (Default: The memory capacity of the machine.)
-| Recommend memory settings for the given amount of memory, instead of the total memory of the system running the command. Valid units are: `k`, `K`, `m`, `M`, `g`, `G`.
+|--verbose
+|Enable verbose output.
+|
 |===
 
 == Considerations