add Jens suggestions

Author: renetapopova

modules/ROOT/pages/configuration/cypher-version-configuration.adoc

@@ -21,6 +21,15 @@ For example, `CREATE DATABASE mydb SET DEFAULT LANGUAGE CYPHER 25` or `ALTER DAT
 For more details and examples, see xref:database-administration/syntax.adoc#administration-syntax-database-management[Database management command syntax] and the respective pages in the xref:database-administration/index.adoc[] section. +
 If not specified, the default language for the database is set to the default language of the DBMS.
 Setting the default language requires the `SET DATABASE DEFAULT LANGUAGE` privilege.
++
+[NOTE]
+====
+Setting the default language to `CYPHER 25` ensures that all queries run on that database will use the version of `Cypher 25` that the database is currently running (unless you prepend your queries with `CYPHER 5`, which overrides this default).
+For example, a Neo4j 2025.08 database with default language `Cypher 25` will use `Cypher 25` as it exists in Neo4j 2025.08, including any changes introduced in Neo4j 2025.06, 2025.07, and 2025.08.
+
+Setting the default language to `CYPHER 5` ensures that all queries run on that database will use the version of `Cypher 5` as it existed at the time of the Neo4j 2025.06 release (unless you prepend your queries with `CYPHER 25`, which overrides this default).
+Any changes introduced after the 2025.06 release will not affect the semantics of the query.
+====
 
 Set the Cypher version on a per-query basis::
 The default language for a specific query can be set by prepending the query with the `CYPHER 5` or `CYPHER 25` keyword. +

modules/ROOT/pages/database-administration/aliases/manage-aliases-standard-databases.adoc

@@ -506,6 +506,12 @@ SHOW ALIAS `remote-with-default-language` FOR DATABASE YIELD name, defaultLangua
 +--------------------------------------------------+
 ----
 
+[NOTE]
+====
+Setting the default language to `CYPHER 25` ensures that all queries run on that database will use the version of `Cypher 25` that the database is currently running (unless you prepend your queries with `CYPHER 5`, which overrides this default).
+For example, a Neo4j 2025.08 database with default language `Cypher 25` will use `Cypher 25` as it exists in Neo4j 2025.08, including any changes introduced in Neo4j 2025.06, 2025.07, and 2025.08.
+====
+
 ==== Set properties for remote database aliases
 
 You can set properties for remote database aliases using the `PROPERTIES` clause of the `CREATE ALIAS` command.
@@ -644,6 +650,12 @@ ALTER ALIAS `remote-with-default-language`
 SET DATABASE DEFAULT LANGUAGE CYPHER 5
 ----
 
+[NOTE]
+====
+Setting the default language to `CYPHER 5` ensures that all queries run on that database will use the version of `Cypher 5` as it existed at the time of the Neo4j 2025.06 release (unless you prepend your queries with `CYPHER 25`, which overrides this default).
+Any changes introduced after the 2025.06 release will not affect the semantics of the query.
+====
+
 === Alter properties of local and remote database aliases
 
 You can alter the properties of a local or remote database alias using the `SET DATABASE PROPERTIES` clause of the `ALTER ALIAS` command.

modules/ROOT/pages/database-administration/composite-databases/alter-composite-databases.adoc

@@ -22,7 +22,7 @@ SET DEFAULT LANGUAGE CYPHER {5\|25}
 |===
 
 [role=label--new-2025.06]
-== Change the default Cypher version of a composite database
+== Alter the default Cypher version of a composite database
 
 You can change the default Cypher version of an existing composite database using the `ALTER DATABASE` command with the `SET DEFAULT LANGUAGE` clause.
 For example:
@@ -48,4 +48,10 @@ include::partial$/view-cypher-version.adoc[]
 | "system"    | "CYPHER 25"
 
 2+d|Rows: 5
-|===
+|===
+
+[NOTE]
+====
+Setting the default language to `CYPHER 25` ensures that all queries run on that database will use the version of `Cypher 25` that the database is currently running (unless you prepend your queries with `CYPHER 5`, which overrides this default).
+For example, a Neo4j 2025.08 database with default language `Cypher 25` will use `Cypher 25` as it exists in Neo4j 2025.08, including any changes introduced in Neo4j 2025.06, 2025.07, and 2025.08.
+====

modules/ROOT/pages/database-administration/composite-databases/create-composite-databases.adoc

@@ -95,7 +95,7 @@ The `IF NOT EXISTS` and `OR REPLACE` parts of these commands cannot be used toge
 
 [role=label--new-2025.06]
 [[composite-databases-default-language]]
-== Set the default Cypher version for a composite database
+== Set a default Cypher version for a composite database
 
 You can set the default Cypher version for a composite database when creating it.
 If not specified, the default language for the composite database is set to the default language of the DBMS.
@@ -126,3 +126,9 @@ include::partial$/view-cypher-version.adoc[]
 |===
 
 For more information about other options for configuring the Cypher version, see xref:configuration/cypher-version-configuration.adoc[Configure the Cypher default version].
+
+[NOTE]
+====
+Setting the default language to `CYPHER 5` ensures that all queries run on that database will use the version of `Cypher 5` as it existed at the time of the Neo4j 2025.06 release (unless you prepend your queries with `CYPHER 25`, which overrides this default).
+Any changes introduced after the 2025.06 release will not affect the semantics of the query.
+====

modules/ROOT/pages/database-administration/standard-databases/alter-databases.adoc

@@ -102,7 +102,7 @@ SET ACCESS READ WRITE
 
 [role=label--new-2025.06]
 [[alter-database-default-language]]
-== Alter database default Cypher version
+== Alter the default Cypher version of an existing database
 
 You can change the default Cypher version of an existing database, including the `system` database, using the `ALTER DATABASE` command with the `SET DEFAULT LANGUAGE` clause.
 For example:
@@ -128,6 +128,11 @@ include::partial$/view-cypher-version.adoc[]
 2+d|Rows: 4
 |===
 
+[NOTE]
+====
+Setting the default language to `CYPHER 25` ensures that all queries run on that database will use the version of `Cypher 25` that the database is currently running (unless you prepend your queries with `CYPHER 5`, which overrides this default).
+For example, a Neo4j 2025.08 database with default language `Cypher 25` will use `Cypher 25` as it exists in Neo4j 2025.08, including any changes introduced in Neo4j 2025.06, 2025.07, and 2025.08.
+====
 
 [role=label--enterprise-edition label--not-on-aura]
 == Alter database topology

modules/ROOT/pages/database-administration/standard-databases/create-databases.adoc

@@ -373,10 +373,10 @@ The `IF NOT EXISTS` and `OR REPLACE` parts of these commands cannot be used toge
 ====
 
 [role=label--new-2025.06]
-== Create a database with `DEFAULT LANGUAGE`
+== Set a default Cypher version for a standard database
 
 You can set the default Cypher version for a database when creating it.
-If not specified, the default language for the database is set to the default language of the DBMS.
+If not specified, the version for that database will be set to the default Cypher version of the DBMS.
 For example:
 
 [source, cypher]
@@ -400,4 +400,10 @@ include::partial$/view-cypher-version.adoc[]
 2+d|Rows: 4
 |===
 
-For more information about other options for configuring the Cypher version, see xref:configuration/cypher-version-configuration.adoc[Configure the Cypher default version].
+For more information about other options for configuring the Cypher version, see xref:configuration/cypher-version-configuration.adoc[Configure the Cypher default version].
+
+[NOTE]
+====
+Setting the default language to `CYPHER 25` ensures that all queries run on that database will use the version of `Cypher 25` that the database is currently running (unless you prepend your queries with `CYPHER 5`, which overrides this default).
+For example, a Neo4j 2025.08 database with default language `Cypher 25` will use `Cypher 25` as it exists in Neo4j 2025.08, including any changes introduced in Neo4j 2025.06, 2025.07, and 2025.08.
+====