Update Analytics-and-telemetry.md

Author: Frooodle

docs/Analytics-and-telemetry.md

@@ -11,7 +11,7 @@ id: analytics-telemetry
 
 Stirling‑PDF uses analytics to understand usage patterns and improve the application. This page explains what data is collected, why we collect it, and how to disable analytics if desired.
 
-> **User control**: All analytics are **opt‑in via a consent banner** (Disabled unless user allows) unless a self‑hosted administrator disables analytics system‑wide. If analytics are disabled system‑wide, no banner is shown.
+> **User control**: All analytics are **opt‑in via a consent banner** (Disabled untill a user expressly allows it) a self‑hosted administrator can also disables all analytics system‑wide. If analytics are disabled system‑wide, no banner is shown.
 
 ## Overview
 
@@ -116,13 +116,13 @@ Scarf is opt‑in by default (via the cookie consent banner). To disable the Sca
 
 **Environment variable**
 ```bash
-SYSTEM_DISABLEPIXEL=true
+SYSTEM_ENABLESCARF=false
 ```
 
 **settings.yml**
 ```yaml
 system:
-  disablePixel: true
+  enableScarf: false
 ```
 
 ---
@@ -168,24 +168,24 @@ system:
 
 **Scarf tracking pixel**
 ```bash
-SYSTEM_DISABLEPIXEL=true
+SYSTEM_ENABLESCARF=false
 ```
 ```yaml
 system:
-  disablePixel: true     # true | false
+  enableScarf: false     # true | false | null
 ```
 
 **Interaction**
 - If `enableAnalytics` is `false`, everything is off regardless of component toggles.
 - If `enableAnalytics` is `true`/`null`, the consent banner is shown (see below). After consent:
   - PostHog runs only if `enablePosthog` is `true`/`null` **and** the user consented.
-  - Scarf runs only if `disablePixel` is `false` **and** the user consented.
+  - Scarf runs only if `enableScarf` is `true`/`null` **and** the user consented.
 
 ### 3) Cookie consent banner
 
 When analytics are allowed globally (`system.enableAnalytics: true` or resolved via the first‑run admin choice), users see a cookie consent banner on their first visit. Users can:
 
-- **Accept all** → enables PostHog (if `enablePosthog` is `true`/`null`) and Scarf (if `disablePixel: false`)
+- **Accept all** → enables PostHog (if `enablePosthog` is `true`/`null`) and Scarf (if `enableScarf` is `true`/`null`)
 - **Accept only necessary** → disables PostHog and Scarf
 - **Customize** → granular selection where applicable