feat: docu for the delete-stale-nodes command

Signed-off-by: Julian Koberg <julian.koberg@kiteworks.com>

Author: Julian Koberg

services/storage-users/README.md

@@ -140,6 +140,50 @@ ocis storage-users uploads sessions --expired=true --clean
 ocis storage-users uploads sessions --processing=true --has-virus=false --resume
 ```
 
+
+#### Delete Stale Nodes command
+
+This command allows to remove (or revert) nodes that are stale, meaning they are in postprocessing but their upload session is gone.
+It will check all nodes that are in postprocessing and find those without an upload session. Then it will delete the node if there are no other versions. If there are other versions, it will instead revert the node to the previous version.
+
+```bash
+    ~/ocis storage-users uploads delete-stale-nodes <commandoptions>
+```
+```
+NAME:
+   ocis storage-users uploads delete-stale-nodes - Delete (or revert) all nodes in processing state that are not referenced by any upload session
+
+USAGE:
+   ocis storage-users uploads delete-stale-nodes [command options]
+
+OPTIONS:
+   --spaceid value  Space ID to check for processing nodes (omit to check all spaces)
+   --dry-run        Only show what would be deleted without actually deleting (default: true)
+   --verbose        Enable verbose logging (default: false)
+   --help, -h       show help
+```
+
+#### Command Examples
+
+Dry run to see what would be deleted (recommended first step)
+
+```bash
+ocis storage-users uploads delete-stale-nodes
+```
+
+Set `--dry-run=false` to actually delete the stale nodes
+
+```bash
+ocis storage-users uploads delete-stale-nodes --dry-run=false
+```
+
+Use `--verbose` to get more information about what is happening
+
+```bash
+ocis storage-users uploads delete-stale-nodes --dry-run=false --verbose
+```
+
+
 ### Manage Spaces
 
 This command set provides commands to manage spaces, including purging disabled spaces that exceed the retention period.

services/storage-users/pkg/command/uploads.go

@@ -336,7 +336,7 @@ func buildInfo(filter storage.UploadSessionFilter) string {
 func DeleteStaleProcessingNodes(cfg *config.Config) *cli.Command {
 	return &cli.Command{
 		Name:  "delete-stale-nodes",
-		Usage: "Delete all nodes in processing state that are not referenced by any upload session",
+		Usage: "Delete (or revert) all nodes in processing state that are not referenced by any upload session",
 		Flags: []cli.Flag{
 			&cli.StringFlag{
 				Name:     "spaceid",