Apply suggestions from code review

Co-authored-by: Jens Pryce-Åklundh <[email protected]>

Author: nadja-muller

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -180,7 +180,7 @@ USE graph.propertiesByName('composite.with.dot.constituent')
 |
 In Cypher 25, xref::values-and-types/graph-references.adoc[Graph references] in arguments of the functions xref:functions/graph.adoc#functions-graph-byname[`graph.byName`] and xref:functions/graph.adoc#functions-graph-propertiesByName[`graph.propertiesByName`] now require no syntactic quotes.
 
-In Cypher 5, there was some special logic for composite databases or constituents with dots, which required quotes around those name parts in order to find the name, e.g. `USE graph.byName('`composite.with.dot++`.constituent')++`.
+In Cypher 5, if a composite database or constituent name contains dots, those name parts have to be wrapped in quotes to resolve the name correctly,  e.g., `USE graph.byName('`composite.with.dot++`.constituent')++`.
 
 a|
 label:functionality[]

modules/ROOT/pages/values-and-types/graph-references.adoc

@@ -2,11 +2,12 @@
 :description: Information about Cypher's graph reference values.
 
 Graph references are values used to specify which graph is targeted in a query.
-They are principally used with the xref:clauses/use.adoc[`USE`] clause, xref:functions/graph.adoc[graph functions], such as `graph.byName()` and when referring to databases and aliases in administration commands.
+They are principally used with the xref:clauses/use.adoc[`USE`] clause, xref:functions/graph.adoc[graph functions], such as `graph.byName()`, and when referring to databases and aliases in link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/[administration commands].
 
-The output of the name column in `SHOW DATABASES` and `SHOW ALIASES FOR DATABASE` can be used as an identifier when referring to a specific graph references.
+The `name` column output from link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/listing-databases/#_show_databases_output[`SHOW DATABASES`] and link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/aliases/manage-aliases-composite-databases/#manage-aliases-composite-databases-list[`SHOW ALIASES FOR DATABASE`] can be used as identifiers for graph references.
 
-When referring to a constituent in a composite database, the identifier is defined as <composite-name>.<alias-name>, where the dot functions as a separator between the composite database name and the alias name. While we do not recommend creating databases or aliases containing dots, it is possible to refer to the alias `some.alias` in the composite `some.composite` as `some.composite.some.alias`.
+When referring to a constituent in a composite database, the identifier is defined as `<composite-name>.<alias-name>`, where the dot functions as a separator between the composite database name and the alias name.
+Although creating databases or aliases containing dots is not recommended, it is possible to refer to the alias `some.alias` in the composite `some.composite` as `some.composite.some.alias`.
 
 [[static-graph-references]]
 == Static graph references
@@ -30,11 +31,12 @@ These include:
 [[rules]]
 == Rules
 
-The following rules apply for graph references when using identifiers (static graph references, administration commands) or the `graph.byName` functions.
+The following rules apply for graph references when using identifiers (static graph references, administration commands) or the `graph.byName` function.
 
-`USE graph.byName(<graph-reference>)` is typically equivalent to `USE <graph-reference>`. There may be differences if the name contains special characters:
+`USE graph.byName(<graph-reference>)` is typically equivalent to `USE <graph-reference>`.
+There may be differences if the name contains special characters:
 
-* Graph references passed as identifiers such as `USE <graph-reference>` apply the escaping rules of xref::syntax/naming.adoc#symbolic-names-escaping-rules[symbolic names]. Graph names can either be unquoted or need to be quoted in its entirety, e.g. `USE neo4j` or `USE `db-with-dash``.
+* Graph references passed as identifiers such as `USE <graph-reference>` apply the escaping rules of xref::syntax/naming.adoc#symbolic-names-escaping-rules[symbolic names]. Graph names can either be unquoted (e.g. ,`USE neo4j`) or need to be quoted in its entirety (e.g., `USE `db-with-dash``).
 
 * Graph references passed as graph functions such as `USE graph.byName(<graph-reference>)` apply the escaping rules of xref:values-and-types/boolean-numeric-string.adoc#string-literal-escape-sequences[string literals]. Note that quotes are considered as part of the name, e.g. `USE graph.byName(++'`db-with-dash`')++` would try to resolve the graph reference `++`db-with-dash++``.