Merge pull request #6858 from FlowFuse/refersh-documentation

Docs: update documentation to reflect latest release changes

Author: Steve-Mcl

docs/device-agent/running.md

@@ -46,12 +46,12 @@ The following command line options are available:
 ```
 Options
 
-  -c, --config file     Device configuration file. Default: device.yml
-  -d, --dir dir         Where the agent should store its state. Default: /opt/flowfuse-device
+  -c, --config file           Device configuration file. Default: device.yml
+  -d, --dir dir               Where the agent should store its state. Default: /opt/flowfuse-device
   -i, --interval secs
   -p, --port number
-  -m, --moduleCache     Use local npm module cache rather than install
-  --node-options        Adds NodeJS command line arguments, can be specified multiple times, you must include = between the option and the value
+  -m, --moduleCache           Use local npm module cache rather than install
+  --node-options string       Node.js command-line options to pass to the Node-RED process. Can be specified multiple times. You must use `=` between the option and its value.
 
 Web UI Options
 
@@ -90,10 +90,36 @@ _Start the agent with a different working directory and the Web UI enabled_
 flowfuse-device-agent -d /path/to/working/directory -w --ui-user admin --ui-pass password --ui-port 8081
 ```
 
-_Start the agent with a larger NodeJS memory space and using the openssl CA certs_
+## Configuring Node.js Options
+
+Node.js command-line arguments can be passed to the Node-RED process started by the Device Agent. This is useful for memory-intensive workflows or certificate management.
+
+### Via command line
+
+Use `--node-options` — it can be specified multiple times:
 
 ```bash
-flowfuse-device-agent -d /path/to/working/directory --node-options='--max-old-space-size=1024' --node_options='--use-openssl-ca'
+# Set a custom heap size limit
+flowfuse-device-agent --node-options='--max-old-space-size=256'
+
+# Enable system certificate authorities (Linux)
+flowfuse-device-agent --node-options='--use-openssl-ca'
+
+# Enable system certificate authorities (Windows/macOS)
+flowfuse-device-agent --node-options='--use-system-ca'
+
+# Combine multiple options
+flowfuse-device-agent --node-options='--max-old-space-size=256' --node-options='--use-openssl-ca'
+```
+
+### Via `device.yml`
+
+Add a `nodeOptions` array to the `device.yml` configuration file:
+
+```yaml
+nodeOptions:
+  - "--max-old-space-size=256"
+  - "--use-openssl-ca"
 ```
 
 ## Running behind a HTTP Proxy

docs/user/expert/chat.md

@@ -191,6 +191,12 @@ If you have multiple questions, consider asking them separately so the Expert ca
 
 *See also: [Node-RED Embedded AI](/docs/user/expert/node-red-embedded-ai/) for AI features built directly into the Node-RED editor.*
 
+## Keeping Expert Up to Date
+
+When a newer version of FlowFuse Expert is available, a banner appears in the chat area to let you know. You can update with a single click directly from the notification, without leaving your current workflow.
+
+![FlowFuse Expert Update Banner](../images/assistant/ff-expert-update-banner.gif){data-zoomable}
+
 <style>
   .assistant-feature {
     border: 1px solid #ddd;