Remove useExisting option; polish examples & page

Author: stefano-ottolenghi

modules/ROOT/pages/database-administration/standard-databases/seed-from-uri.adoc

@@ -1,5 +1,5 @@
 :page-role: enterprise-edition
-:description: How to create a database using a seed from URI. 
+:description: How to create a database using a seed from URI.
 
 [[database-seed-uri]]
 = Create a database from a URI
@@ -8,15 +8,15 @@ This method seeds all databases with an identical seed from an external source,
 
 You specify the seed URI as an argument of the `CREATE DATABASE` command:
 
-[source, cypher, role="noplay"]
+[source, cypher]
 ----
-CREATE DATABASE foo OPTIONS {existingData: 'use', seedURI:'s3://myBucket/myBackup.backup'}
+CREATE DATABASE foo OPTIONS { seedURI:'s3://myBucket/myBackup.backup' }
 ----
 
 Download and validation of the seed is only performed as the new database is started.
 If it fails, the database is not available and it has the `statusMessage`: `Unable to start database` of the `SHOW DATABASES` command.
 
-[source, cypher, role="noplay"]
+[source, cypher]
 ----
 neo4j@neo4j> SHOW DATABASES;
 +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -26,7 +26,7 @@ neo4j@neo4j> SHOW DATABASES;
 +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 ----
 
-To determine the cause of the problem, it is recommended to look at the `debug.log`.
+To determine the cause of the problem, check the `debug.log` file.
 
 [NOTE]
 ====
@@ -90,9 +90,9 @@ include::partial$/aws-s3-credentials.adoc[]
 
 . Create database from `myBackup.backup`.
 +
-[source,shell, role="nocopy"]
+[source,cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3://myBucket/myBackup.backup' }
+CREATE DATABASE foo OPTIONS { seedURI: 's3://myBucket/myBackup.backup' }
 ----
 
 ======
@@ -103,9 +103,9 @@ include::partial$/gcs-credentials.adoc[]
 
 . Create database from `myBackup.backup`.
 +
-[source,shell]
+[source,cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 'gs://myBucket/myBackup.backup' }
+CREATE DATABASE foo OPTIONS { seedURI: 'gs://myBucket/myBackup.backup' }
 ----
 ======
 [role=include-with-Azure-cloud-storage]
@@ -115,9 +115,9 @@ include::partial$/azb-credentials.adoc[]
 
 . Create database from `myBackup.backup`.
 +
-[source,shell]
+[source,cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 'azb://myStorageAccount/myContainer/myBackup.backup' }
+CREATE DATABASE foo OPTIONS { seedURI: 'azb://myStorageAccount/myContainer/myBackup.backup' }
 ----
 ======
 =====
@@ -129,26 +129,32 @@ Starting from Neo4j 2025.01, the `CloudSeedProvider` supports seeding up to a sp
 [role=label--new-2025.01]
 Seed up to a specific date::
 
-To seed up to a specific date, you need to pass the differential backup, which contains the data up to that date.
+To seed up to a specific date, provide the differential backup containing the data up to that date.
 +
-[source,shell]
+[source,cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3://myBucket/myBackup.backup', seedRestoreUntil: datetime("2019-06-01T18:40:32.142+0100") }
+CREATE DATABASE foo OPTIONS {
+    seedURI: 's3://myBucket/myBackup.backup',
+    seedRestoreUntil: datetime('2019-06-01T18:40:32.142+0100')
+}
 ----
 +
 This will seed the database with transactions committed before the provided timestamp.
 
 [role=label--new-2025.01]
 Seed up to a specific transaction ID::
 
-To seed up to a specific transaction ID, you need to pass the differential backup that contains the data up to that transaction ID.
+To seed up to a specific transaction ID, pass the differential backup containing the data up to that transaction ID.
 +
-[source,shell]
+[source,cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3://myBucket/myBackup.backup', seedRestoreUntil: 123 }
+CREATE DATABASE foo OPTIONS {
+    seedURI: 's3://myBucket/myBackup.backup',
+    seedRestoreUntil: 123
+}
 ----
 +
-This will seed the database with transactions up to, but not including transaction 123.
+This will seed the database with transactions up to (but not including) transaction 123.
 
 [role=label--deprecated]
 [[s3-seed-provider]]
@@ -164,31 +170,37 @@ The `S3SeedProvider` supports:
 [NOTE]
 ====
 Neo4j comes bundled with necessary libraries for AWS S3 connectivity.
-Therefore, if you use `S3SeedProvider`,`aws cli` is not required but can be used with the `CloudSeedProvider`.
+Therefore, if you use `S3SeedProvider`, `aws cli` is not required (as it instead is with `CloudSeedProvider`).
 ====
 
 The `S3SeedProvider` requires additional configuration.
-This is specified with the `seedConfig` option.
-This option expects a comma-separated list of configurations.
-Each configuration value is specified as a name followed by `=` and the value, as such:
+This is specified with the `seedConfig` option, which expects a comma-separated list of configurations.
+Each configuration entry is specified in the format `key=value`, as such:
 
-[source, cypher, role="noplay"]
+[source, cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3://myBucket/myBackup.backup', seedConfig: 'region=eu-west-1' }
+CREATE DATABASE foo OPTIONS {
+    seedURI: 's3://myBucket/myBackup.backup',
+    seedConfig: 'region=eu-west-1'
+}
 ----
 
 `S3SeedProvider` also requires passing in credentials.
 These are specified with the `seedCredentials` option.
 Seed credentials are securely passed from the Cypher command to each server hosting the database.
 For this to work, Neo4j on each server in the cluster must be configured with identical keystores.
 This is identical to the configuration required by remote aliases, see xref:database-administration/aliases/remote-database-alias-configuration.adoc#remote-alias-config-DBMS_admin-A[Configuration of DBMS with remote database alias].
-If this configuration is not performed, the `seedCredentials` option fails.
+Without this configuration, the `seedCredentials` option fails.
 
-[source, cypher, role="noplay"]
+[source, cypher]
 ----
-CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3://myBucket/myBackup.backup', seedConfig: 'region=eu-west-1', seedCredentials: [accessKey];[secretKey] }
+CREATE DATABASE foo OPTIONS {
+    seedURI: 's3://myBucket/myBackup.backup',
+    seedConfig: 'region=eu-west-1',
+    seedCredentials: <accessKey>;<secretKey>
+}
 ----
-Where `accessKey` and `secretKey` are provided by AWS.
+Where `<accessKey>` and `<secretKey>` are provided by AWS.
 
 === Seed provider reference
 
@@ -226,4 +238,4 @@ Where `accessKey` and `secretKey` are provided by AWS.
 | `azb:`
 | `CloudSeedProvider`
 | `azb://mystorageaccount.blob/backupscontainer/backup1.backup`
-|===
+|===