Cypher25 default language

[renetapopova]

Replaces #2153

[Hunterness]

Only got started on the review, have looked at 11/21 files and have all the big ones left. But figured I'd post the comments I have so far as I'm pausing for the day.

[Hunterness]

is there actually any syntax differences in alter that would require the tabbed examples? 🤔 the previous PR didn't do tabs for alter 🤷

[renetapopova]

Do we have SET DEFAULT LANGUAGE CYPHER {5\|25} now? If yes, from which version of the server is it available? It's not in the docs.

[Hunterness]

Marks PR was the one to add it to docs so yeah, it's not documented yet...

The command has been merged to both Cypher 5 and 25, but only the SET ... 5 version is generally available as the 25 option is hidden behind the cypher 25 feature flag. We decided that we didn't want to add it to documentation until both values were available, and then document that it exists in both Cypher 5 and Cypher 25.

So for both create and alter, all 4 of:

CYPHER 5 CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 5
CYPHER 5 CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 25
CYPHER 25 CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 5
CYPHER 25 CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 25 

will be valid once we release Cypher 25, but at the moment only

CYPHER 5 CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 5

is, hence us skipping documenting it until all 4 is allowed if that makes sense

[renetapopova]

But this is true only if you are running a server on a version before 2025.06, right? Would it be true if you're on 2025.05, 2025.04, etc?

[renetapopova]

Because if they are on a version, let's say 2025.03, SET DEFAULT LANGUAGE won't be available at all.

[Hunterness]

This comment can be resolved, but let's reply to the questions first:

But this is true only if you are running a server on a version before 2025.06, right? Would it be true if you're on 2025.05, 2025.04, etc?
Because if they are on a version, let's say 2025.03, SET DEFAULT LANGUAGE won't be available at all.

Officially yes, it should only be available from 2025.06 and forward for both Cypher 5 and Cypher 25. Unofficially, there is some versions where CREATE/ALTER DATABASE foo SET DEFAULT LANGUAGE CYPHER 5 is available earlier than that as well but we don't care to document/say that it was so, it's neater to just say both became available now 🤷

[Hunterness]

Still have 2 files left to look at, the privilege file (how did you get over 700 lines changed from our 90 something on the previous PR? XD) and the manage aliases for standard database file (only like 200 more lines changed than the previous PR :P)

[Hunterness]

Review of alias page

[Hunterness]

Started on the privilege file updates

[Hunterness]

Next chunk of the privilege file updates

[Hunterness]

Got through the file, now everything have been looked at once

[renetapopova]

@Hunterness, could you please check where it should be SET DEFAULT LANGUAGE CYPHER {5|25}, [SET DEFAULT LANGUAGE CYPHER {5|25}], [DEFAULT LANGUAGE CYPHER {5|25}], DEFAULT LANGUAGE CYPHER {5|25}? I think they are inconsistent across Cypher 5 and Cypher 25, as well as across commands.

[mnd999]

@renetapopova just checking, you do know that SET DEFAULT LANGUAGE is also in Cypher 5?

[renetapopova]

@renetapopova just checking, you do know that SET DEFAULT LANGUAGE is also in Cypher 5?

Is this a question to my question above or separate?

[renetapopova]

In some places, it is with SET, in some without. Sometimes, it's optional, and sometimes, it's not. Hence, my question above.

[mnd999]

@renetapopova separate. I haven't been able to find the Cypher 5 docs for the release, and tracking the PR history is quite tricky. I want to make sure we documented SET DEFAULT LANGUAGE in both language versions.

From looking at the parser, SET is mandatory on ALTER DATABASE, and from Cypher 25 optional on CREATE DATABASE

[Hunterness]

Some extra comments from review of neo4j/docs-cypher#1327

[Hunterness]

might need a tag to be able to link to this page, see: neo4j/docs-cypher#1327 (comment)

[Hunterness]

you resolved it without adding a tag or a comment saying you skipped it 🤷 (and if you have just fixed it locally I guess I'll re-resolve it once you've pushed that and I've checked it off :P)

[renetapopova]

I added the anchor [[grant-privilege-alter-composite-database]] so that we can link to it. What do you mean by tag?

[Hunterness]

just be aware hat you need to update the rest of the example to match with the new name as well

[renetapopova]

I am not sure what you mean

[Hunterness]

that got worse

[neo4j-docops-agent]

This PR includes documentation updates
View the updated docs at https://neo4j-docs-operations-2372.surge.sh

New pages:

• Configure the Cypher default version
• Alter composite databases
• Start and stop composite databases
• Start and stop databases

Updated pages:

• DBMS privileges
• Copy a database store
• Configuration
• Managing database aliases in composite databases
• Managing database aliases for standard databases
• Create composite databases
• List composite databases
• Database administration
• Alter databases