Update docs

Signed-off-by: JeffMboya <[email protected]>

Author: JeffMboya

docs/dev-guide/kubernetes.md

@@ -548,38 +548,127 @@ helm install magistrala -n mg --set ingress.hostname='example.com' --set users.i
 
 If Magistrala is already installed and you want to update it with new settings (for example, changing the ingress hostname or image tag), you can use the `helm upgrade` command:
 
-## Scaling Services
+Here’s a **refined and polished version** of your documentation. It improves clarity, structure, consistency, and polish—while still being technically precise and aligned with the `supermq` base chart model:
+
+---
 
-The Magistrala Core includes the essential services that are installed by default:
+## Magistrala Add-ons
 
-- authn
-- users
-- clients
-- adapter_http
-- adapter_mqtt
-- adapter_coap
-- ui
+Magistrala provides a set of **optional services** designed to extend the capabilities of the [**SuperMQ**](https://github.com/absmach/supermq) IoT platform. These services are **not installed by default** and are treated as **add-ons**, each packaged as a sub-chart within the SuperMQ Helm chart.
 
-These are the minimum required services to run Magistrala.
+To enable any add-on, pass the appropriate `--set` flags when installing or upgrading the SuperMQ chart.
 
-### Magistrala Add-ons
+> **Note:** Magistrala add-ons **cannot run standalone**. They depend on the core services provided by the `supermq` base chart (e.g., authentication, messaging, internal APIs).
 
-Magistrala Add-ons are optional services that are not installed by default. To enable an add-on, you need to specify it during installation. For example, to enable the InfluxDB reader and writer, you would use the following command:
+Example: Enabling InfluxDB Reader and Writer
 
 ```bash
-helm install magistrala . -n mg --set influxdb=true
+helm install supermq . -n mg \
+  --set influxdb.reader.enabled=true \
+  --set influxdb.writer.enabled=true
 ```
 
-Here’s a list of available add-ons:
+## Available Add-ons
+
+### 1. **Bootstrap Service**
 
-- bootstrap
-- influxdb.writer
-- influxdb.reader
-- adapter_opcua
-- adapter_lora
-- twins
+Provides initial configuration for newly connected devices and services.
+
+- Generates bootstrap tokens
+- Applies provisioning templates
+- Integrates with the provisioning service
+
+```bash
+--set bootstrap.enabled=true
+```
+
+### 2. **InfluxDB Integration**
+
+Stores and retrieves time-series telemetry using InfluxDB.
+
+- **Writer**
+  - Consumes data and writes to InfluxDB.
+  ```bash
+  --set influxdb.writer.enabled=true
+  ```
+- **Reader**
+  - Serves historical time-series queries.
+  ```bash
+  --set influxdb.reader.enabled=true
+  ```
 
-### Scaling Services
+### 3. **Protocol Adapters**
+
+Adapters ingest data from external protocols and systems.
+
+- **OPC-UA Adapter**  
+  Integrates with industrial machines using the OPC-UA protocol.
+
+  ```bash
+  --set adapter.opcua.enabled=true
+  ```
+
+- **LoRa Adapter**  
+  Connects to LoRa/LPWAN gateways (e.g., The Things Network).
+  ```bash
+  --set adapter.lora.enabled=true
+  ```
+
+> _Note: Some adapters may require external credentials or broker configuration._
+
+### 4. **Twins Service**
+
+Creates and manages digital twins of physical devices.
+
+- Tracks device state
+- Simulates device behavior
+- Supports virtual device interactions
+
+```bash
+--set twins.enabled=true
+```
+
+### 5. **PostgreSQL / TimescaleDB Integration**
+
+Support for structured and time-series storage using PostgreSQL or TimescaleDB.
+
+- **Writer**
+
+  ```bash
+  --set postgres.writer.enabled=true
+  ```
+
+- **Reader**
+  ```bash
+  --set postgres.reader.enabled=true
+  ```
+
+### 6. **Notifier Services**
+
+Delivers alerts or notifications based on system events or rules.
+
+- **SMTP (Email) Notifier**
+
+  ```bash
+  --set notifiers.smtp.enabled=true
+  ```
+
+- **SMPP (SMS) Notifier**
+  ```bash
+  --set notifiers.smpp.enabled=true
+  ```
+
+### 7. **Rule Engine (RE)**
+
+Evaluates conditions and executes automated actions based on incoming data.
+
+```bash
+--set ruleengine.enabled=true
+```
+
+---
+
+## Scaling Services
 
 By default, the MQTT adapter, Clients, Envoy, Authn, and the Message Broker services are set to scale with a replica count of 3. It’s recommended to set these values according to the number of nodes in your Kubernetes cluster. For example, you can adjust the replica count with the following command: