graph references in Cypher 25

[nadja-muller]

No description provided.

[Hunterness]

I agree that it's very USE centric, might be nice to have some mention of the admin commands as well and where they fall on the scales? 🤔

[Hunterness]

Have some new comments 🎁

[Hunterness]

Suggested change

	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. This deprecations apply to 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`]. In Cypher 25 the graph references can be passed in without quoting
	as in the name column from `SHOW ALIASES FOR DATABASE`.Note that escaping graph names within the graph functions string argument is not supported in Cypher 5.
	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.
	This deprecations apply to 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`].
	In Cypher 25 the graph references can be passed in without quoting as in the name column from `SHOW ALIASES FOR DATABASE`.
	Note that escaping graph names within the graph functions string argument is not supported in Cypher 5.

Usually we split the lines between sentences and not in the middle of sentences

[nadja-muller]

Ah...I guess there are no deprecations in cypher 25 yet. So this is about what we newly support. I'll try to reformulate this a little.

[Hunterness]

I guess we would want to also add something for the removal of the old deprecation and introduction of the new + the breaking change, might be easier to just have that in this PR as well to not need 2 graph ref related cypher manual docs PRs 🤔

[nadja-muller]

Woudn't it be better to port Louise's changes to this branch instead of doing them twice?

[nadja-muller]

We discussed that we can take over the deprecations from neo4j/docs-status-codes#340 after that one is merged. This can also be in a follow up PR.

[neo4j-docops-agent]

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.