diff --git a/common-content/modules/ROOT/partials/upgrade.adoc b/common-content/modules/ROOT/partials/upgrade.adoc index 23d22209..16c84203 100644 --- a/common-content/modules/ROOT/partials/upgrade.adoc +++ b/common-content/modules/ROOT/partials/upgrade.adoc @@ -1,11 +1,8 @@ # tag::intro[] -This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. + +This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. For a full list of changes, see the link:{driver-changelog-url}[Driver -> Changelog]. -[NOTE] -This page may be revised with new changes up until when the latest 5.x version is released. - The link:https://github.com/neo4j/drivers-migration-assistent[Neo4j Drivers Migration Assistent] simplifies the upgrade process by contextualizing the changelog to your application. It scans your codebase for usage of deprecations and removals, and brings them up to you. The tool doesn't automatically rewrite your code; it only points at where action is needed, providing in-context information on how each hit should be addressed. diff --git a/dotnet-manual/modules/ROOT/pages/upgrade.adoc b/dotnet-manual/modules/ROOT/pages/upgrade.adoc index 1c648a9a..9da86718 100644 --- a/dotnet-manual/modules/ROOT/pages/upgrade.adoc +++ b/dotnet-manual/modules/ROOT/pages/upgrade.adoc @@ -2,12 +2,9 @@ = Upgrade from older versions -This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. + +This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. For a full list of changes, see the link:{driver-changelog-url}[Driver -> Changelog]. -[NOTE] -This page may be revised with new changes up until when the latest 5.x version is released. - The latest driver version of the 5.x series (5.27) is compatible with Neo4j server both 4.4 and 5.x, so you can upgrade the driver before you upgrade the server. At the same time, the driver version 4.4 is forward compatible with Neo4j server 5.x, so you could also upgrade the server before the driver; however, given that it's easier to roll back an application upgrade than a server upgrade, it's recommended to start with the driver. diff --git a/go-manual/modules/ROOT/pages/connect-advanced.adoc b/go-manual/modules/ROOT/pages/connect-advanced.adoc index d63e4d0c..5d2bb36d 100644 --- a/go-manual/modules/ROOT/pages/connect-advanced.adoc +++ b/go-manual/modules/ROOT/pages/connect-advanced.adoc @@ -64,6 +64,7 @@ driver, err := neo4j.NewDriverWithContext(dbUri, neo4j.NoAuth()) ---- +[#rotating-tokens] [role=label--new-5.14] == Rotating authentication tokens diff --git a/go-manual/modules/ROOT/pages/upgrade.adoc b/go-manual/modules/ROOT/pages/upgrade.adoc index 7c50e025..0c5974f8 100644 --- a/go-manual/modules/ROOT/pages/upgrade.adoc +++ b/go-manual/modules/ROOT/pages/upgrade.adoc @@ -1,23 +1,8 @@ -= Upgrade from older versions - -This page contains the list of new features and breaking changes that happened in the driver from version 4.4 to 5.x. -For a full list of changes, see the link:https://github.com/neo4j/neo4j-go-driver/wiki/5.x-changelog[Driver -> Changelog]. - -The link:https://github.com/neo4j/drivers-migration-assistant[Neo4j Drivers Migration Assistant] simplifies the upgrade process, by contextualizing the changelog to your codebase. -It scans your codebase for usage of deprecations and removals, and brings them up to you. -The tool doesn't automatically rewrite your code; it only points at where action is needed, providing in-context information on how each hit should be addressed. +:driver-changelog-url: https://github.com/neo4j/neo4j-go-driver/wiki/5.x-changelog -The migration assistant requires `python3`. - -Any of the 5.x versions of the driver is compatible both with Neo4j server 4.4 and 5.x, so you can upgrade the driver before you upgrade the server. -The driver version 4.4 is forward compatible with Neo4j server 5.x as well, so you could also upgrade the server before the driver; however, given that it's easier to roll back an application upgrade than a server upgrade, it's recommended to start with the driver. - -[TIP] -When upgrading the Neo4j server to a newer version, the Cypher queries in your application may also need updating. + -See link:https://neo4j.com/docs/cypher-manual/current/deprecations-additions-removals-compatibility/[Cypher -> Deprecations, additions, and compatibility]. += Upgrade from older versions -[NOTE] -If migrating from earlier than version 4.x, see the link:https://github.com/neo4j/neo4j-go-driver/blob/v4.0.0-beta1/MIGRATIONGUIDE.md[migration guide to version 4] first. +include::{common-partial}/upgrade.adoc[tag=intro] [[recommended-steps]] diff --git a/java-manual/modules/ROOT/pages/connect-advanced.adoc b/java-manual/modules/ROOT/pages/connect-advanced.adoc index f5a7a0f0..be116319 100644 --- a/java-manual/modules/ROOT/pages/connect-advanced.adoc +++ b/java-manual/modules/ROOT/pages/connect-advanced.adoc @@ -72,6 +72,7 @@ GraphDatabase.driver(dbUri, AuthTokens.custom(principal, credentials, realm, sch If authentication is disabled on the server, the authentication parameter can be omitted entirely. +[#rotating-tokens] [role=label--new-5.18] == Rotating authentication tokens diff --git a/java-manual/modules/ROOT/pages/upgrade.adoc b/java-manual/modules/ROOT/pages/upgrade.adoc index 70cfbb9a..9932ae0b 100644 --- a/java-manual/modules/ROOT/pages/upgrade.adoc +++ b/java-manual/modules/ROOT/pages/upgrade.adoc @@ -2,7 +2,7 @@ = Upgrade from older versions -This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. + +This page contains the list of new features and breaking changes of the driver from version 4.4 to 5.x. For a full list of changes, see the link:{driver-changelog-url}[Driver -> Changelog]. The latest driver version of the 5.x series (5.27) is compatible with Neo4j server both 4.4 and 5.x, so you can upgrade the driver before you upgrade the server. diff --git a/javascript-manual/modules/ROOT/pages/connect-advanced.adoc b/javascript-manual/modules/ROOT/pages/connect-advanced.adoc index 011bbc01..fc630117 100644 --- a/javascript-manual/modules/ROOT/pages/connect-advanced.adoc +++ b/javascript-manual/modules/ROOT/pages/connect-advanced.adoc @@ -65,6 +65,7 @@ const driver = neo4j.driver( If authentication is disabled on the server, the authentication parameter can be omitted entirely. +[#rotating-tokens] [role=label--new-5.14] == Rotating authentication tokens diff --git a/python-manual/modules/ROOT/pages/connect-advanced.adoc b/python-manual/modules/ROOT/pages/connect-advanced.adoc index c1d391a5..75de50b7 100644 --- a/python-manual/modules/ROOT/pages/connect-advanced.adoc +++ b/python-manual/modules/ROOT/pages/connect-advanced.adoc @@ -63,6 +63,7 @@ Use the function link:{neo4j-docs-base-uri}/api/python-driver/current/api.html#n If authentication is disabled on the server, the authentication parameter can be omitted entirely. +[#rotating-tokens] [role=label--new-5.14] == Rotating authentication tokens diff --git a/python-manual/modules/ROOT/pages/upgrade.adoc b/python-manual/modules/ROOT/pages/upgrade.adoc index e88b17a2..41c23f62 100644 --- a/python-manual/modules/ROOT/pages/upgrade.adoc +++ b/python-manual/modules/ROOT/pages/upgrade.adoc @@ -1,18 +1,8 @@ -= Upgrade from older versions - -This page contains the list of new features and breaking changes that happened in the driver from version 4.4 to 5.x. + -For a full list of changes, see the link:https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog[Driver -> Changelog]. +:driver-changelog-url: https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog -The link:https://github.com/neo4j/drivers-migration-assistant[Neo4j Drivers Migration Assistant] simplifies the upgrade process, by contextualizing the changelog to your codebase. -It scans your codebase for usage of deprecations and removals, and brings them up to you. -The tool doesn't automatically rewrite your code; it only points at where action is needed, providing in-context information on how each hit should be addressed. - -Any of the 5.x versions of the driver is compatible both with Neo4j server 4.4 and 5.x, so you can upgrade the driver before you upgrade the server. -The driver version 4.4 is forward compatible with Neo4j server 5.x as well, so you could also upgrade the server before the driver; however, given that it's easier to roll back an application upgrade than a server upgrade, it's recommended to start with the driver. += Upgrade from older versions -[TIP] -When upgrading the Neo4j server to a newer version, the Cypher queries in your application may also need updating. + -See link:https://neo4j.com/docs/cypher-manual/current/deprecations-additions-removals-compatibility/[Cypher -> Deprecations, additions, and compatibility]. +include::{common-partial}/upgrade.adoc[tag=intro] [[recommended-steps]]