[Docs]: Add MQTT documentation (#1939)

* Add comprehensive MQTT integration documentation

- Add new docs-site/docs/mqtt-integration.md with complete MQTT guide
  - Configuration options and examples
  - Message format and status values
  - Home Assistant and Node-RED integration examples
  - Testing and troubleshooting sections
  - Security considerations
  - Architecture details with diagrams
  - Advanced use cases (office signs, Slack sync, Grafana)
- Update docs-site/docs/index.md to list MQTT as a main feature
- Update docs-site/docs/configuration.md with MQTT configuration section
- Add mqtt-integration to docs-site/sidebars.ts navigation

This addresses the lack of user-facing documentation for the MQTT
feature introduced in PR #1926, making it discoverable and providing
comprehensive guidance for home automation integration.

* Update MQTT documentation with corrections and improvements

- Add "disabled by default" notice at the top
- Update broker URL formats section to note WebSocket URLs are untested
- Replace specific Home Assistant/Node-RED examples with call to action
  for users to share their working automations on GitHub Discussions
- Fix debug logging to use ELECTRON_ENABLE_LOGGING=true format and
  link to troubleshooting guide instead of incorrect config options
- Revise security considerations with stronger warning about sharing
  status externally and reference to LICENSE.md disclaimer
- Remove "Advanced Configuration" section
- Remove "Use Case Examples" section (office signs, Slack sync, Grafana)

These changes make the documentation more accurate, conservative about
untested features, and encourage community contributions of working
automation configurations.

* Replace GitHub Discussions references with Issues and Matrix chat

* Add MQTT documentation release note to version 2.6.3 in appdata.xml

* Update docs-site/docs/mqtt-integration.md

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update docs-site/docs/mqtt-integration.md

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

---------

Co-authored-by: Claude <[email protected]>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: 3 people

com.github.IsmaelMartinez.teams_for_linux.appdata.xml

@@ -108,6 +108,7 @@
 					<li>Fix: Proper event listener cleanup to prevent memory leaks when ConnectionManager is restarted</li>
 					<li>Enhancement: Add start:dev npm script with --no-sandbox flag for easier development testing</li>
 					<li>Fix: Revert to core22 and Electron 37.7.0 for snap compatibility - electron-builder doesn't support core24 yet (issue #8548)</li>
+					<li>Documentation: Add comprehensive MQTT integration documentation with configuration guide, troubleshooting, and home automation examples</li>
 				</ul>
 			</description>
 		</release>

docs-site/docs/configuration.md

@@ -14,6 +14,7 @@ This document details all available configuration options for the Teams for Linu
   - [Notifications & UI](#notifications--ui)
   - [Screen Sharing & Media](#screen-sharing--media)
   - [System Integration](#system-integration)
+  - [MQTT Integration](#mqtt-integration)
   - [Advanced Options](#advanced-options)
 - [Usage Examples & Guides](#usage-examples--guides)
   - [Basic Setup Examples](#basic-setup-examples)
@@ -123,6 +124,38 @@ Place your `config.json` file in the appropriate location based on your installa
 | `disableGlobalShortcuts` | `array` | `[]` | Array of global shortcuts to disable while app is in focus |
 | `globalShortcuts` | `array` | `[]` | Global keyboard shortcuts that work system-wide (opt-in, disabled by default). See [Global Shortcuts](#global-shortcuts) |
 
+### MQTT Integration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `mqtt.enabled` | `boolean` | `false` | Enable/disable MQTT status publishing |
+| `mqtt.brokerUrl` | `string` | `""` | MQTT broker URL (e.g., `mqtt://192.168.1.100:1883` or `mqtts://broker:8883` for TLS) |
+| `mqtt.username` | `string` | `""` | MQTT username for authentication (optional) |
+| `mqtt.password` | `string` | `""` | MQTT password for authentication (optional) |
+| `mqtt.clientId` | `string` | `"teams-for-linux"` | Unique MQTT client identifier |
+| `mqtt.topicPrefix` | `string` | `"teams"` | Topic prefix for all MQTT messages |
+| `mqtt.statusTopic` | `string` | `"status"` | Topic name for status messages (combined with topicPrefix) |
+| `mqtt.statusCheckInterval` | `number` | `10000` | Polling interval in milliseconds for status detection fallback |
+
+**Example MQTT Configuration:**
+```json
+{
+  "mqtt": {
+    "enabled": true,
+    "brokerUrl": "mqtt://192.168.1.100:1883",
+    "username": "teams-user",
+    "password": "secret",
+    "clientId": "teams-for-linux",
+    "topicPrefix": "home/office",
+    "statusTopic": "teams/status",
+    "statusCheckInterval": 10000
+  }
+}
+```
+
+> [!NOTE]
+> Messages are published to `{topicPrefix}/{statusTopic}` (e.g., `home/office/teams/status`). See the **[MQTT Integration Guide](mqtt-integration.md)** for complete documentation, home automation examples, and troubleshooting.
+
 ### Advanced Options
 
 | Option | Type | Default | Description |

docs-site/docs/index.md

@@ -8,16 +8,17 @@ slug: /
 
 **Unofficial Microsoft Teams client for Linux** — a native desktop app that wraps the Teams web version with enhanced Linux integration.
 
-✅ **System notifications**  
-✅ **System tray integration**  
-✅ **Custom backgrounds & themes**  
-✅ **Screen sharing support**  
-✅ **Multiple account profiles**  
-✅ **Certificate management**  
-✅ **Proxy server support**  
-✅ **Microsoft Intune SSO integration**  
-✅ **Secure token storage**  
-✅ **Protocol handler support**  
+✅ **System notifications**
+✅ **System tray integration**
+✅ **Custom backgrounds & themes**
+✅ **Screen sharing support**
+✅ **Multiple account profiles**
+✅ **Certificate management**
+✅ **Proxy server support**
+✅ **Microsoft Intune SSO integration**
+✅ **Secure token storage**
+✅ **Protocol handler support**
+✅ **MQTT integration for home automation**
 ✅ **Advanced logging & debugging**
 
 :::info Project Status
@@ -36,6 +37,7 @@ This is an independent project, not affiliated with Microsoft. Some features are
 - **[Screen Sharing Guide](screen-sharing.md)** - Complete screen sharing implementation and usage
 - **[Custom Backgrounds](custom-backgrounds.md)** - Setting up custom video call backgrounds
 - **[Certificate Management](certificate.md)** - Custom CA certificate handling for corporate environments
+- **[MQTT Integration](mqtt-integration.md)** - Home automation and status publishing via MQTT
 
 ## Developer Documentation
 - **[Contributing Guide](development/contributing.md)** - Development setup, code standards, and contribution guidelines