Document the updated include-metadata=users for backup command (#2683)

Co-authored-by: Phil Wright <[email protected]>

Author: NataliaIvakina

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

@@ -64,13 +64,11 @@ For more information, see xref:backup-restore/online-backup.adoc#online-backup-c
 
 [source,role=noheader]
 ----
-neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [--verbose]
-                            [--compress[=true|false]] [--keep-failed[=true|false]]
-                            [--parallel-recovery[=true|false]] [--remote-address-resolution
-                            [=true|false]] [--additional-config=<file>]
-                            [--include-metadata=none|all|users|roles] [--inspect-path=<path>]
-                            [--pagecache=<size>] [--temp-path=<path>] [--to-path=<path>]
-                            [--type=<type>] [--from=<host:port>[,<host:port>...]]... [<database>...]
+neo4j-admin database backup [-h] [--expand-commands] [--prefer-diff-as-parent] [--verbose] [--compress[=true|false]]
+                            [--keep-failed[=true|false]] [--parallel-recovery[=true|false]] [--remote-address-resolution
+                            [=true|false]] [--additional-config=<file>] [--include-metadata=none|all|users[=user1,user2]
+                            |roles] [--inspect-path=<path>] [--pagecache=<size>] [--temp-path=<path>]
+                            [--to-path=<path>] [--type=<type>] [--from=<host:port>[,<host:port>...]]... [<database>...]
 ----
 
 === Description
@@ -128,11 +126,11 @@ If <database> is "*", `neo4j-admin` will attempt to back up all databases of the
 |Show this help message and exit.
 |
 
-|--include-metadata=none\|all\|users\|roles
-|Include metadata in the file. This cannot be used for backing up the `system` database. Possible values are:
+|--include-metadata=none\|all\|users[=user1,user2]\|roles
+|label:new[Changed in 2025.10] Include metadata in the file. This cannot be used for backing up the `system` database. Possible values are:
 
 - `roles` - include commands to create the roles and privileges (for both database and graph) that affect the use of the database.
-- `users` - include commands to create the users that can use the database and their role assignments.
+- `users` - include commands to create the users that can use the database and their role assignments. If a list of users is specified (e.g. `users=alice,bob,charlie`), only those users are included in the backup.
 - `all` - include both `roles` and `users`.
 - `none` - does not include any metadata.
 [NOTE]

modules/ROOT/pages/changes-deprecations-removals.adoc

@@ -598,9 +598,19 @@ The section covers changes to Neo4j server functionality across different areas.
 
 === Neo4j-admin tool
 
+Neo4j 2025.10::
+
+* label:enterprise[Enterprise Edition] The `neo4j-admin database backup` command.
++
+The `--include-metadata=none|all|users[=user1,user2]|roles` option is changed.
+Now it allows filtering users when performing a database backup. +
+Previously, if you specified `users` with `--include-metadata`, the backup file would include commands to create the users that can use the database and their role assignments.
+Starting from 2025.10, you can define a list of specific users (e.g., `users=alice,bob,charlie`), which means only those users are included in the backup.
+For details, refer to xref:backup-restore/online-backup.adoc[].
+
 Neo4j 2025.01::
 
-* The `neo4j-admin database copy` command.
+* label:enterprise[Enterprise Edition] The `neo4j-admin database copy` command.
 +
 The functionality of the `--from-pagecache=<size>` option is changed. +
 Instead of specifying how much cache to allocate when reading the source, now you can control the maximum amount of off-heap memory used for the copy operation, both for reading and writing.