update cscli docs for 1.6.5 (#733)

* update cscli docs for 1.6.5

* Remove backup/restore from sidebar

---------

Co-authored-by: Laurence Jones <[email protected]>

Author: mmetc

crowdsec-docs/docs/cscli/cscli_appsec-configs.md

@@ -10,10 +10,10 @@ Manage hub appsec-configs
 
 ```
 cscli appsec-configs list -a
-cscli appsec-configs install crowdsecurity/vpatch
-cscli appsec-configs inspect crowdsecurity/vpatch
-cscli appsec-configs upgrade crowdsecurity/vpatch
-cscli appsec-configs remove crowdsecurity/vpatch
+cscli appsec-configs install crowdsecurity/virtual-patching
+cscli appsec-configs inspect crowdsecurity/virtual-patching
+cscli appsec-configs upgrade crowdsecurity/virtual-patching
+cscli appsec-configs remove crowdsecurity/virtual-patching
 
 ```
 

crowdsec-docs/docs/cscli/cscli_appsec-configs_inspect.md

@@ -17,7 +17,17 @@ cscli appsec-configs inspect [item]... [flags]
 ### Examples
 
 ```
-cscli appsec-configs inspect crowdsecurity/vpatch
+# Display metadata, state, metrics and ancestor collections of appsec-configs (installed or not).
+cscli appsec-configs inspect crowdsecurity/virtual-patching
+
+# Don't collect metrics (avoid error if crowdsec is not running).
+cscli appsec-configs inspect crowdsecurity/virtual-patching --no-metrics
+
+# Display difference between a tainted item and the latest one.
+cscli appsec-configs inspect crowdsecurity/virtual-patching --diff
+
+# Reverse the above diff
+cscli appsec-configs inspect crowdsecurity/virtual-patching --diff --rev
 ```
 
 ### Options

crowdsec-docs/docs/cscli/cscli_appsec-configs_install.md

@@ -17,16 +17,35 @@ cscli appsec-configs install [item]... [flags]
 ### Examples
 
 ```
-cscli appsec-configs install crowdsecurity/vpatch
+# Install some appsec-configs.
+cscli appsec-configs install crowdsecurity/virtual-patching
+
+# Show the execution plan without changing anything - compact output sorted by type and name.
+cscli appsec-configs install crowdsecurity/virtual-patching --dry-run
+
+# Show the execution plan without changing anything - verbose output sorted by execution order.
+cscli appsec-configs install crowdsecurity/virtual-patching --dry-run -o raw
+
+# Download only, to be installed later.
+cscli appsec-configs install crowdsecurity/virtual-patching --download-only
+
+# Install over tainted items. Can be used to restore or repair after local modifications or missing dependencies.
+cscli appsec-configs install crowdsecurity/virtual-patching --force
+
+# Prompt for confirmation if running in an interactive terminal; otherwise, the option is ignored.
+cscli appsec-configs install crowdsecurity/virtual-patching -i
+cscli appsec-configs install crowdsecurity/virtual-patching --interactive
 ```
 
 ### Options
 
 ```
   -d, --download-only   Only download packages, don't enable
+      --dry-run         Don't install or remove anything; print the execution plan
       --force           Force install: overwrite tainted and outdated files
   -h, --help            help for install
       --ignore          Ignore errors when installing multiple appsec-configs
+  -i, --interactive     Ask for confirmation before proceeding
 ```
 
 ### Options inherited from parent commands

crowdsec-docs/docs/cscli/cscli_appsec-configs_list.md

@@ -17,9 +17,14 @@ cscli appsec-configs list [item... | -a] [flags]
 ### Examples
 
 ```
+# List enabled (installed) appsec-configs.
 cscli appsec-configs list
+
+# List all available appsec-configs (installed or not).
 cscli appsec-configs list -a
-cscli appsec-configs list crowdsecurity/vpatch
+
+# List specific appsec-configs (installed or not).
+cscli appsec-configs list crowdsecurity/virtual-patching crowdsecurity/generic-rules
 ```
 
 ### Options

crowdsec-docs/docs/cscli/cscli_appsec-configs_remove.md

@@ -17,16 +17,35 @@ cscli appsec-configs remove [item]... [flags]
 ### Examples
 
 ```
-cscli appsec-configs remove crowdsecurity/vpatch
+# Uninstall some appsec-configs.
+cscli appsec-configs remove crowdsecurity/virtual-patching
+
+# Show the execution plan without changing anything - compact output sorted by type and name.
+cscli appsec-configs remove crowdsecurity/virtual-patching --dry-run
+
+# Show the execution plan without changing anything - verbose output sorted by execution order.
+cscli appsec-configs remove crowdsecurity/virtual-patching --dry-run -o raw
+
+# Uninstall and also remove the downloaded files.
+cscli appsec-configs remove crowdsecurity/virtual-patching --purge
+
+# Remove tainted items.
+cscli appsec-configs remove crowdsecurity/virtual-patching --force
+
+# Prompt for confirmation if running in an interactive terminal; otherwise, the option is ignored.
+cscli appsec-configs remove crowdsecurity/virtual-patching -i
+cscli appsec-configs remove crowdsecurity/virtual-patching --interactive
 ```
 
 ### Options
 
 ```
-      --all     Remove all the appsec-configs
-      --force   Force remove: remove tainted and outdated files
-  -h, --help    help for remove
-      --purge   Delete source file too
+      --all           Remove all the appsec-configs
+      --dry-run       Don't install or remove anything; print the execution plan
+      --force         Force remove: remove tainted and outdated files
+  -h, --help          help for remove
+  -i, --interactive   Ask for confirmation before proceeding
+      --purge         Delete source file too
 ```
 
 ### Options inherited from parent commands

crowdsec-docs/docs/cscli/cscli_appsec-configs_upgrade.md

@@ -17,15 +17,31 @@ cscli appsec-configs upgrade [item]... [flags]
 ### Examples
 
 ```
-cscli appsec-configs upgrade crowdsecurity/vpatch
+# Upgrade some appsec-configs. If they are not currently installed, they are downloaded but not installed.
+cscli appsec-configs upgrade crowdsecurity/virtual-patching
+
+# Show the execution plan without changing anything - compact output sorted by type and name.
+cscli appsec-configs upgrade crowdsecurity/virtual-patching --dry-run
+
+# Show the execution plan without changing anything - verbose output sorted by execution order.
+cscli appsec-configs upgrade crowdsecurity/virtual-patching --dry-run -o raw
+
+# Upgrade over tainted items. Can be used to restore or repair after local modifications or missing dependencies.
+cscli appsec-configs upgrade crowdsecurity/virtual-patching --force
+
+# Prompt for confirmation if running in an interactive terminal; otherwise, the option is ignored.
+cscli appsec-configs upgrade crowdsecurity/virtual-patching -i
+cscli appsec-configs upgrade crowdsecurity/virtual-patching --interactive
 ```
 
 ### Options
 
 ```
-  -a, --all     Upgrade all the appsec-configs
-      --force   Force upgrade: overwrite tainted and outdated files
-  -h, --help    help for upgrade
+  -a, --all           Upgrade all the appsec-configs
+      --dry-run       Don't install or remove anything; print the execution plan
+      --force         Force upgrade: overwrite tainted and outdated files
+  -h, --help          help for upgrade
+  -i, --interactive   Ask for confirmation before proceeding
 ```
 
 ### Options inherited from parent commands

crowdsec-docs/docs/cscli/cscli_appsec-rules_inspect.md

@@ -17,7 +17,17 @@ cscli appsec-rules inspect [item]... [flags]
 ### Examples
 
 ```
+# Display metadata, state, metrics and ancestor collections of appsec-rules (installed or not).
 cscli appsec-rules inspect crowdsecurity/crs
+
+# Don't collect metrics (avoid error if crowdsec is not running).
+cscli appsec-configs inspect crowdsecurity/crs --no-metrics
+
+# Display difference between a tainted item and the latest one.
+cscli appsec-rules inspect crowdsecurity/crs --diff
+
+# Reverse the above diff
+cscli appsec-rules inspect crowdsecurity/crs --diff --rev
 ```
 
 ### Options

crowdsec-docs/docs/cscli/cscli_appsec-rules_install.md

@@ -17,16 +17,35 @@ cscli appsec-rules install [item]... [flags]
 ### Examples
 
 ```
+# Install some appsec-rules.
 cscli appsec-rules install crowdsecurity/crs
+
+# Show the execution plan without changing anything - compact output sorted by type and name.
+cscli appsec-rules install crowdsecurity/crs --dry-run
+
+# Show the execution plan without changing anything - verbose output sorted by execution order.
+cscli appsec-rules install crowdsecurity/crs --dry-run -o raw
+
+# Download only, to be installed later.
+cscli appsec-rules install crowdsecurity/crs --download-only
+
+# Install over tainted items. Can be used to restore or repair after local modifications or missing dependencies.
+cscli appsec-rules install crowdsecurity/crs --force
+
+# Prompt for confirmation if running in an interactive terminal; otherwise, the option is ignored.
+cscli appsec-rules install crowdsecurity/crs -i
+cscli appsec-rules install crowdsecurity/crs --interactive
 ```
 
 ### Options
 
 ```
   -d, --download-only   Only download packages, don't enable
+      --dry-run         Don't install or remove anything; print the execution plan
       --force           Force install: overwrite tainted and outdated files
   -h, --help            help for install
       --ignore          Ignore errors when installing multiple appsec-rules
+  -i, --interactive     Ask for confirmation before proceeding
 ```
 
 ### Options inherited from parent commands

crowdsec-docs/docs/cscli/cscli_appsec-rules_list.md

@@ -17,9 +17,14 @@ cscli appsec-rules list [item... | -a] [flags]
 ### Examples
 
 ```
+# List enabled (installed) appsec-rules.
 cscli appsec-rules list
+
+# List all available appsec-rules (installed or not).
 cscli appsec-rules list -a
-cscli appsec-rules list crowdsecurity/crs
+
+# List specific appsec-rules (installed or not).
+cscli appsec-rules list crowdsecurity/crs crowdsecurity/vpatch-git-config
 ```
 
 ### Options

crowdsec-docs/docs/cscli/cscli_appsec-rules_remove.md

@@ -17,16 +17,35 @@ cscli appsec-rules remove [item]... [flags]
 ### Examples
 
 ```
+# Uninstall some appsec-rules.
 cscli appsec-rules remove crowdsecurity/crs
+
+# Show the execution plan without changing anything - compact output sorted by type and name.
+cscli appsec-rules remove crowdsecurity/crs --dry-run
+
+# Show the execution plan without changing anything - verbose output sorted by execution order.
+cscli appsec-rules remove crowdsecurity/crs --dry-run -o raw
+
+# Uninstall and also remove the downloaded files.
+cscli appsec-rules remove crowdsecurity/crs --purge
+
+# Remove tainted items.
+cscli appsec-rules remove crowdsecurity/crs --force
+
+# Prompt for confirmation if running in an interactive terminal; otherwise, the option is ignored.
+cscli appsec-rules remove crowdsecurity/crs -i
+cscli appsec-rules remove crowdsecurity/crs --interactive
 ```
 
 ### Options
 
 ```
-      --all     Remove all the appsec-rules
-      --force   Force remove: remove tainted and outdated files
-  -h, --help    help for remove
-      --purge   Delete source file too
+      --all           Remove all the appsec-rules
+      --dry-run       Don't install or remove anything; print the execution plan
+      --force         Force remove: remove tainted and outdated files
+  -h, --help          help for remove
+  -i, --interactive   Ask for confirmation before proceeding
+      --purge         Delete source file too
 ```
 
 ### Options inherited from parent commands