Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces #310

JoelBergstrand · 2025-10-22T09:00:43Z

Changes and clarification from PR.

…reserved and deprecated namespaces

modules/ROOT/pages/extending-neo4j/aggregation-functions.adoc

modules/ROOT/pages/extending-neo4j/functions.adoc

modules/ROOT/pages/extending-neo4j/procedures.adoc

NataliaIvakina · 2025-10-22T12:24:20Z

A very good clarification and addition. Thank you, @JoelBergstrand!
I have only one question: For which Neo4j versions is this valid?

JoelBergstrand · 2025-10-22T14:17:47Z

@NataliaIvakina, this will be valid for 2025.11 and forward. Some of it applies to earlier version as well but not the information about deprecations.

Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com>

modules/ROOT/pages/extending-neo4j/procedures.adoc

NataliaIvakina · 2025-10-23T07:10:58Z

@NataliaIvakina, this will be valid for 2025.11 and forward. Some of it applies to earlier version as well but not the information about deprecations.

So, I assume we have to reflect this information in the Deprecations columns. Mark it with the Deprecated in 2025.11 label? Or just say 'Deprecated since 2025.10'?
@JoelBergstrand, could you please specify what exactly is applicable to earlier versions and which versions (5.x, 2025.01-2025.09), so I can transfer this to the 5.x and publish (main) branch?

Please do not merge this PR till 2025.10 docs are published.

modules/ROOT/pages/extending-neo4j/aggregation-functions.adoc

modules/ROOT/pages/extending-neo4j/functions.adoc

modules/ROOT/pages/extending-neo4j/procedures.adoc

JoelBergstrand · 2025-10-23T09:21:26Z

@NataliaIvakina, the reserved columns are correct for 5.x and 2025.x-10. It is only the mentions of deprecations that are new behavior in 2025.11.

I can leave the merging to you if you are okey with that.

NataliaIvakina · 2025-10-23T09:52:51Z

@NataliaIvakina, the reserved columns are correct for 5.x and 2025.x-10. It is only the mentions of deprecations that are new behavior in 2025.11.

I can leave the merging to you if you are okey with that.

Ok, nice! I'll take care of this PR, no probs. I'll also raise PRs against the 5.x and main branches and ping you to review them.

Lojjs

Do you think we want to mention explicitly that the deprecated namespaces will be restricted in the future or do you think that is easy to understand?

Apart from this question which I am unsure about, this documentation looks good I think.

modules/ROOT/pages/extending-neo4j/procedures.adoc

NataliaIvakina · 2025-10-23T12:33:36Z

Do you think we want to mention explicitly that the deprecated namespaces will be restricted in the future or do you think that is easy to understand?

Apart from this question which I am unsure about, this documentation looks good I think.

@Lojjs hi! I think it's clear enough that the deprecated namespaces will remain deprecated in future releases.
But what exactly do you mean by 'the deprecated namespaces will be restricted'? Do we need to add extra details of what will happen to those deprecated namespaces?
If I read the text correctly, your user-defined function/procedure with the same name as a built-in procedure in a deprecated namespace will override the built-in procedure.

JoelBergstrand · 2025-10-28T08:27:27Z

@NataliaIvakina, I think what @Lojjs is referring to is that the namespaces are deprecated in the Cypher 25 version. So will be move to reserved in the next Cypher version whenever that is. Maybe we should make that more apparent to the users.

modules/ROOT/pages/extending-neo4j/aggregation-functions.adoc

modules/ROOT/pages/extending-neo4j/functions.adoc

modules/ROOT/pages/extending-neo4j/procedures.adoc

neo4j-docops-agent · 2025-12-09T09:56:12Z

Thanks for the documentation updates.

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

…reserved and deprecated namespaces (neo4j#310) * Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces * Apply suggestions from code review Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> * Updated deprecating root for procedures * Update modules/ROOT/pages/extending-neo4j/procedures.adoc * Apply suggestions from code review --------- Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com>

* Update antora.yml (#312) * Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces (#310) * Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces * Apply suggestions from code review Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> * Updated deprecating root for procedures * Update modules/ROOT/pages/extending-neo4j/procedures.adoc * Apply suggestions from code review --------- Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> * We have reverted the deprecation of aura.* in product. (#321) --------- Co-authored-by: JoelBergstrand <joel.bergstrand@hotmail.com> Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> Co-authored-by: Louise Berglund <louise.berglund@neo4j.com>

* bump version to 2025.02 (#248) * Bump @neo4j-antora/antora-modify-sitemaps in the prod-dependencies group (#249) Bumps the prod-dependencies group with 1 update: @neo4j-antora/antora-modify-sitemaps. Updates `@neo4j-antora/antora-modify-sitemaps` from 0.6.1 to 0.7.0 --- updated-dependencies: - dependency-name: "@neo4j-antora/antora-modify-sitemaps" dependency-type: direct:production update-type: version-update:semver-minor dependency-group: prod-dependencies ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Update dev version to 2025.03 (#252) * Update version in antora.yml to 2025.03 (#254) * Update Java driver version to 5.28.3 (#258) * Packages workflows refine (#261) * update workflow to 1.2.0 * update packages * Replace `page-version` with `current` in links (#260) * Replace `page-version` with `current` in links * Put back `page-version` for the Ops manual and fix links on locks/deadlocks * Update modules/ROOT/pages/java-embedded/unique-nodes.adoc * Update modules/ROOT/pages/extending-neo4j/unmanaged-extensions.adoc * Update docs-pr-checks.yml (#263) * Update the version to 2025.04 (#268) * Update version to 2025.05 (#271) * Update version to 2025.06 (#277) * Update Java driver version to 5.28.5 (#280) * Update and fix several pages (#279) * Update and fix several pages * Change ClusterSettings to DiscoverySettings * Update Java driver to 5.28.6 (#283) * Bump Neo4j version to 2025.07 (#286) * Update Java driver to 5.28.7 (#287) * Update path to javadocs (#289) * Update path to javadocs * use docs-base-uri in path * Update Java driver version to 5.28.9 (#290) * Update to 2025.08 (#294) * Update to 2025.09 (#298) * Bump to 2025.10, Java driver to 5.28.10 (#302) * Update Java to 21 (#306) * Update Java to 21 * Add a link to the Bolt docs * Update setup.adoc * Update antora.yml (#312) * Update Java Driver to 6.0.2 (#315) * Update Neo4j v. to 2025.12, Java Driver to 6.0.2 * Back to 2025.11 * Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces (#310) * Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces * Apply suggestions from code review Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> * Updated deprecating root for procedures * Update modules/ROOT/pages/extending-neo4j/procedures.adoc * Apply suggestions from code review --------- Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> Co-authored-by: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> * We have reverted the deprecation of aura.* in product. (#321) * Update antora.yml to 2025.12 (#325) --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Reneta Popova <reneta.popova@neo4j.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Neil Dewhurst <neil.dewhurst@neo4j.com> Co-authored-by: JoelBergstrand <joel.bergstrand@hotmail.com> Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com> Co-authored-by: Louise Berglund <louise.berglund@neo4j.com>

Clarified naming rules for user defined callables and added list for …

106ab77

…reserved and deprecated namespaces

JoelBergstrand added the dev dev branch label Oct 22, 2025

rsill-neo4j reviewed Oct 22, 2025

View reviewed changes

rsill-neo4j requested a review from NataliaIvakina October 22, 2025 12:00

Apply suggestions from code review

90b2192

Co-authored-by: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com>

NataliaIvakina added DO NOT MERGE 2025.11 labels Oct 23, 2025

NataliaIvakina reviewed Oct 23, 2025

View reviewed changes

modules/ROOT/pages/extending-neo4j/procedures.adoc Outdated Show resolved Hide resolved

NataliaIvakina reviewed Oct 23, 2025

View reviewed changes

Updated deprecating root for procedures

c9b7999

JoelBergstrand assigned Lojjs Oct 23, 2025

Lojjs reviewed Oct 23, 2025

View reviewed changes

NataliaIvakina reviewed Oct 23, 2025

View reviewed changes

modules/ROOT/pages/extending-neo4j/procedures.adoc Outdated Show resolved Hide resolved

Update modules/ROOT/pages/extending-neo4j/procedures.adoc

1d92880

NataliaIvakina removed the dev dev branch label Oct 27, 2025

NataliaIvakina approved these changes Oct 27, 2025

View reviewed changes

NataliaIvakina removed the DO NOT MERGE label Nov 19, 2025

NataliaIvakina reviewed Dec 8, 2025

View reviewed changes

Apply suggestions from code review

f13d0ab

NataliaIvakina merged commit 8e8ee39 into dev Dec 9, 2025
5 checks passed

NataliaIvakina deleted the clarify-naming-rules branch December 9, 2025 10:08

NataliaIvakina mentioned this pull request Dec 16, 2025

DOCCORE-88 Add reserved procedures/functions namespaces and naming rules #320

Merged

Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces #310

Clarified naming rules for user defined callables and added list for reserved and deprecated namespaces #310

Uh oh!

Conversation

JoelBergstrand commented Oct 22, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

NataliaIvakina commented Oct 22, 2025

Uh oh!

JoelBergstrand commented Oct 22, 2025

Uh oh!

Uh oh!

NataliaIvakina commented Oct 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JoelBergstrand commented Oct 23, 2025

Uh oh!

NataliaIvakina commented Oct 23, 2025

Uh oh!

Lojjs left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

NataliaIvakina commented Oct 23, 2025

Uh oh!

JoelBergstrand commented Oct 28, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

neo4j-docops-agent commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

NataliaIvakina commented Oct 23, 2025 •

edited

Loading

neo4j-docops-agent commented Dec 9, 2025 •

edited

Loading