Scalability docs

modules/ROOT/content-nav.adoc

@@ -130,25 +130,8 @@
 *** xref:database-administration/aliases/manage-aliases-standard-databases.adoc[]
 *** xref:database-administration/aliases/manage-aliases-composite-databases.adoc[]
 *** xref:database-administration/aliases/remote-database-alias-configuration.adoc[]
-** Composite databases
-*** xref:database-administration/composite-databases/concepts.adoc[]
-*** xref:database-administration/composite-databases/create-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/list-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/alter-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/start-stop-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/delete-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/querying-composite-databases.adoc[]
-*** xref:database-administration/composite-databases/sharding-with-copy.adoc[]
 ** xref:database-administration/routing-decisions.adoc[]
 
-* xref:database-internals/index.adoc[]
-** xref:database-internals/transaction-management.adoc[]
-** xref:database-internals/concurrent-data-access.adoc[]
-** xref:database-internals/transaction-logs.adoc[]
-** xref:database-internals/checkpointing.adoc[]
-** xref:database-internals/store-formats.adoc[]
-** xref:database-internals/neo4j-admin-store-info.adoc[]
-
 * xref:clustering/index.adoc[]
 ** xref:clustering/introduction.adoc[]
 ** Setting up a cluster
@@ -177,6 +160,41 @@
 ** xref:clustering/server-syntax.adoc[]
 ** xref:clustering/glossary.adoc[]
 
+* Scalability
+** xref:scalability/concepts.adoc[]
+** xref:scalability/scaling-with-neo4j.adoc[]
+** Composite databases
+*** xref:scalability/composite-databases/concepts.adoc[]
+*** xref:scalability/composite-databases/create-composite-databases.adoc[]
+*** xref:scalability/composite-databases/list-composite-databases.adoc[]
+*** xref:scalability/composite-databases/alter-composite-databases.adoc[]
+*** xref:scalability/composite-databases/start-stop-composite-databases.adoc[]
+*** xref:scalability/composite-databases/delete-composite-databases.adoc[]
+*** xref:scalability/composite-databases/querying-composite-databases.adoc[]
+*** xref:scalability/composite-databases/sharding-with-copy.adoc[]
+//*** xref:scalability/composite-databases/scaling-with-composite-databases.adoc[]
+** Property sharding (Preview feature)
+*** xref:scalability/sharded-property-databases/overview.adoc[]
+*** xref:scalability/sharded-property-databases/planning-and-sizing.adoc[]
+*** xref:scalability/sharded-property-databases/configuration.adoc[]
+*** xref:scalability/sharded-property-databases/data-ingestion.adoc[]
+*** xref:scalability/sharded-property-databases/starting-stopping-sharded-databases.adoc[]
+*** xref:scalability/sharded-property-databases/listing-sharded-databases.adoc[]
+*** xref:scalability/sharded-property-databases/altering-sharded-databases.adoc[]
+*** xref:scalability/sharded-property-databases/deleting-sharded-databases.adoc[]
+*** xref:scalability/sharded-property-databases/role-based-access-control.adoc[]
+*** xref:scalability/sharded-property-databases/admin-operations.adoc[]
+*** xref:scalability/sharded-property-databases/security.adoc[]
+*** xref:scalability/sharded-property-databases/limitations-and-considerations.adoc[]
+
+* xref:database-internals/index.adoc[]
+** xref:database-internals/transaction-management.adoc[]
+** xref:database-internals/concurrent-data-access.adoc[]
+** xref:database-internals/transaction-logs.adoc[]
+** xref:database-internals/checkpointing.adoc[]
+** xref:database-internals/store-formats.adoc[]
+** xref:database-internals/neo4j-admin-store-info.adoc[]
+
 * xref:backup-restore/index.adoc[]
 ** xref:backup-restore/planning.adoc[]
 ** xref:backup-restore/modes.adoc[]

modules/ROOT/pages/backup-restore/consistency-checker.adoc

@@ -141,7 +141,7 @@ The following are examples of how to check the consistency of a database, a dump
 
 [NOTE]
 ====
-`neo4j-admin database check` cannot be applied to xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+`neo4j-admin database check` cannot be applied to xref:scalability/composite-databases/concepts.adoc[Composite databases].
  It must be run directly on the databases that are associated with that Composite database.
 ====
 

modules/ROOT/pages/backup-restore/copy-database.adoc

@@ -11,7 +11,7 @@ You can use the `neo4j-admin database copy` command to copy a database, create a
 ====
 * `neo4j-admin database copy` preserves the node IDs (unless `--compact-node-store` is used), but the relationships get new IDs.
 * `neo4j-admin database copy` is not supported for use on the `system` database.
-* `neo4j-admin database copy` is not supported for use on xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+* `neo4j-admin database copy` is not supported for use on xref:scalability/composite-databases/concepts.adoc[Composite databases].
 It must be run directly on the databases that are associated with that Composite database.
 * `neo4j-admin database copy` is an IOPS-intensive process.
 For more information, see <<copy-estimating-iops, Estimating the processing time>>.
@@ -300,7 +300,7 @@ Labels are processed independently, i.e., the filter ignores any node with a lab
 
 [TIP]
 ====
-For a detailed example of how to use `neo4j-admin database copy` to filter out data for sharding a database, see xref:database-administration/composite-databases/sharding-with-copy.adoc[Sharding data with the `copy` command].
+For a detailed example of how to use `neo4j-admin database copy` to filter out data for sharding a database, see xref:scalability/composite-databases/sharding-with-copy.adoc[Sharding data with the `copy` command].
 ====
 
 [[compact-database]]

modules/ROOT/pages/backup-restore/offline-backup.adoc

@@ -109,7 +109,7 @@ The command creates a file called _database.dump_ where `database` is the databa
 
 [NOTE]
 ====
-`neo4j-admin database dump` cannot be applied to xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+`neo4j-admin database dump` cannot be applied to xref:scalability/composite-databases/concepts.adoc[Composite databases].
 It must be run directly on the databases that are associated with that Composite database.
 ====
 

modules/ROOT/pages/backup-restore/planning.adoc

@@ -172,7 +172,7 @@ The following table summarizes the commands' capabilities and usage.
 
 [NOTE]
 ====
-The Neo4j Admin commands `backup`, `restore`, `dump`, `load`, `copy`, and `check-consistency` are not supported for use on xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+The Neo4j Admin commands `backup`, `restore`, `dump`, `load`, `copy`, and `check-consistency` are not supported for use on xref:scalability/composite-databases/concepts.adoc[Composite databases].
 They must be run directly on the databases that are associated with that Composite database.
 ====
 
@@ -196,7 +196,7 @@ By default, a database backup includes only the database contents.
 If you choose to include metadata, the backup also stores the role-based access control (RBAC) settings associated with the database.
 
 When restoring, you have the flexibility to define the target topology (how many primaries and secondaries are desired for the database), which may differ from the topology at backup time.
-The database will then be allocated across the available servers according to that topology. 
+The database will then be allocated across the available servers according to that topology.
 ====
 
 [[backup-planning-databases]]

modules/ROOT/pages/backup-restore/restore-dump.adoc

@@ -117,7 +117,7 @@ For more information, see xref:clustering/databases.adoc#cluster-seed[Seed a clu
 
 [NOTE]
 ====
-`neo4j-admin database load` cannot be applied to xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+`neo4j-admin database load` cannot be applied to xref:scalability/composite-databases/concepts.adoc[Composite databases].
 It must be run directly on the databases that are associated with that Composite database.
 ====
 

modules/ROOT/pages/configuration/configuration-settings.adoc

@@ -8,7 +8,7 @@ Refer to xref:configuration/neo4j-conf.adoc#_configuration_settings[The neo4j.co
 
 For lists of deprecated and removed configuration settings in 2025.x, refer to the page xref:changes-deprecations-removals.adoc[Changes, deprecations, and removals in Neo4j 2025.x].
 
-To list all available configuration settings on a Neo4j server, run the link:https://neo4j.com/docs/cypher-manual/5/clauses/listing-settings[`SHOW SETTINGS`] command.
+To list all available configuration settings on a Neo4j server, run the link:{neo4j-docs-base-uri}/cypher-manual/5/clauses/listing-settings[`SHOW SETTINGS`] command.
 
 
 == Dynamic configuration settings

modules/ROOT/pages/configuration/plugins.adoc

@@ -150,7 +150,7 @@ For more information on configuring the plugins, see the respective documentatio
 * link:https://neo4j.com/docs/bloom-user-guide/current/bloom-installation/[Bloom documentation]
 * link:https://neo4j.com/docs/aura/fleet-management/setup/[Fleet management documentation]
 * link:https://neo4j.com/docs/graph-data-science/current/installation/neo4j-server/[GDS documentation]
-* link:https://neo4j.com/docs/cypher-manual/current/genai-integrations/[GenAI documentation]
+* link:{neo4j-docs-base-uri}/cypher-manual/current/genai-integrations/[GenAI documentation]
 * link:https://neo4j.com/labs/neosemantics/[Neosemantics documentation]
 
 . Restart Neo4j for the plugins to be loaded and available for use.

modules/ROOT/pages/database-administration/aliases/manage-aliases-composite-databases.adoc

@@ -56,7 +56,7 @@ For a description of all the returned columns of this command, and for ways in w
 [[create-composite-database-alias]]
 == Create database aliases in composite databases
 
-Both local and remote database aliases can be part of a xref::database-administration/composite-databases/concepts.adoc[composite database].
+Both local and remote database aliases can be part of a xref::scalability/composite-databases/concepts.adoc[composite database].
 
 The database alias consists of two parts, separated by a dot: the namespace and the alias name.
 

modules/ROOT/pages/database-administration/aliases/manage-aliases-standard-databases.adoc

@@ -44,7 +44,7 @@ The home database for users can be set to an alias, which will be resolved to th
 Starting with Neo4j 2025.04, a database alias can also be set as the DBMS default database.
 
 This page describes managing database aliases for standard databases.
-For aliases created as part of a xref:database-administration/composite-databases/concepts.adoc[composite database], see xref:database-administration/aliases/manage-aliases-composite-databases.adoc[].
+For aliases created as part of a xref:scalability/composite-databases/concepts.adoc[composite database], see xref:database-administration/aliases/manage-aliases-composite-databases.adoc[].
 
 [[manage-aliases-list]]
 == List database aliases

modules/ROOT/pages/database-administration/index.adoc

@@ -83,10 +83,10 @@ image::manage-dbs-community.svg[title="A default Neo4j installation.",role=popup
 .An installation of Neo4j with multiple active databases, named `marketing`, `sales`, and `hr`:
 image::manage-dbs-enterprise.svg[title="A multiple database Neo4j installation.",role=popup]
 
-For details about the `system` database in a clustered environment, refer to xref:clustering/databases.adoc#cluster-system-db[Managing databases in a cluster -> The `system` database]. 
+For details about the `system` database in a clustered environment, refer to xref:clustering/databases.adoc#cluster-system-db[Managing databases in a cluster -> The `system` database].
 
 == Composite databases
 
 A Composite database is a logical grouping of multiple graphs contained in other, standard databases.
 A Composite database defines an _execution context_ and a (limited) _transaction domain_.
-For more information, see xref:database-administration/composite-databases/concepts.adoc[Composite databases].
+For more information, see xref:scalability/composite-databases/concepts.adoc[Composite databases].

modules/ROOT/pages/database-administration/routing-decisions.adoc

@@ -21,7 +21,7 @@ Step 2: Reuse open transaction::
 * If not, then proceed to step 3.
 Step 3: Determine the type of the target database (execution context type)::
 * If the target database is a database in this DBMS, then the context type is _Internal_.
-* If the target database is a xref::database-administration/composite-databases/concepts.adoc[Composite database], then the context type is _Composite_. +
+* If the target database is a xref::scalability/composite-databases/concepts.adoc[Composite database], then the context type is _Composite_. +
 +
 [NOTE]
 ====

modules/ROOT/pages/introduction.adoc

@@ -246,7 +246,7 @@ a| APOC 450+ link:https://neo4j.com/docs/apoc/5/[Core Procedures and Functions]
 |
 | {check-mark}
 
-| xref:database-administration/composite-databases/concepts.adoc[Composite databases]
+| xref:scalability/composite-databases/concepts.adoc[Composite databases]
 |
 | {check-mark}
 

modules/ROOT/pages/database-administration/composite-databases/concepts.adoc → modules/ROOT/pages/scalability/composite-databases/concepts.adoc

@@ -13,7 +13,7 @@ Local database aliases target databases within the same DBMS, while remote datab
 For more information, see xref:database-administration/aliases/manage-aliases-composite-databases.adoc[].
 
 Composite databases are managed using Cypher administrative commands.
-For a detailed example of how to create a Composite database and add database aliases to it, see xref:database-administration/composite-databases/querying-composite-databases.adoc[Set up and query composite databases].
+For a detailed example of how to create a Composite database and add database aliases to it, see xref:scalability/composite-databases/querying-composite-databases.adoc[Set up and query composite databases].
 
 Composite databases cannot guarantee compatibility between constituents from different Neo4j versions.
 Constituents from versions without breaking changes should work fine, apart from newly-added features.
@@ -26,7 +26,7 @@ Composite databases have the following characteristics:
 * Can be deployed in standalone and cluster deployments.
 * Managed using Cypher commands, such as `CREATE COMPOSITE DATABASE` and `CREATE ALIAS`.
 * You can shard an existing database with the help of the `neo4j-admin copy` command.
-See xref:database-administration/composite-databases/sharding-with-copy.adoc[Sharding data with the copy command] for details.
+See xref:scalability/composite-databases/sharding-with-copy.adoc[Sharding data with the copy command] for details.
 * Use the existing user for local constituents or the user credentials defined by the remote aliases for remote consituents.
 * Do not support privileges, index, and constraint management commands.
 These must be defined on the constituent target database in the respective DBMS.
@@ -45,7 +45,7 @@ Data sharding is when you have two graphs that share the *same model* (same labe
 For example, you can deploy shards on separate servers, splitting the load on resources and storage.
 Or, you can deploy shards in different locations, to be able to manage them independently or split the load on network traffic.
 An existing database can be sharded with the help of the `neo4j-admin database copy` command.
-For an example, see xref:database-administration/composite-databases/sharding-with-copy.adoc[Sharding data with the copy command].
+For an example, see xref:scalability/composite-databases/sharding-with-copy.adoc[Sharding data with the copy command].
 
 Connecting data across graphs::
 Because relationships cannot span across graphs, to query your data, you have to federate the graphs by

modules/ROOT/pages/database-administration/composite-databases/querying-composite-databases.adoc → modules/ROOT/pages/scalability/composite-databases/querying-composite-databases.adoc

@@ -84,7 +84,7 @@ CREATE ALIAS `cineasts.upcoming`
 ====
 
 
-For more information about composite databases and database aliases in composite databases, see xref:database-administration/composite-databases/concepts.adoc[], and xref:database-administration/aliases/manage-aliases-composite-databases.adoc[].
+For more information about composite databases and database aliases in composite databases, see xref:scalability/composite-databases/concepts.adoc[], and xref:database-administration/aliases/manage-aliases-composite-databases.adoc[].
 
 [[composite-databases-queries-graph-selection]]
 == Graph selection