Refactor enigma2 documentation (#37073)

* Refactor enigma2 documentation

* Add more docs for quality scale

* typo

* CodeRabbit review

* Fix

* Fix

* Review

* Review

source/_integrations/enigma2.markdown

@@ -14,8 +14,84 @@ ha_platforms:
 ha_integration_type: device
 ---
 
-The `enigma2` platform allows you to control a Linux based set-top box which is running [Enigma2](https://github.com/oe-alliance/oe-alliance-enigma2) with the OpenWebif plugin installed.
+The **Enigma2** {% term integration %} allows you to control a Linux based set-top box which is running [Enigma2](https://github.com/oe-alliance/oe-alliance-enigma2) with the OpenWebif plugin installed.
 
-[OpenWebif](https://github.com/E2OpenPlugins/e2openplugin-OpenWebif) is an open source web interface for Enigma2 based set-top boxes.
+[OpenWebif](https://github.com/E2OpenPlugins/e2openplugin-OpenWebif) is an open-source web interface for Enigma2 based set-top boxes.
+
+### Prerequisites
+
+Your device needs to have the OpenWebif plugin installed. On most devices it is installed by default, if not, it is available via the Plugins menu within your Enigma2 distribution.
+
+Please beware that the OpenWebif setting "Require client cert for HTTPS" is not supported.
 
 {% include integrations/config_flow.md %}
+
+{% configuration_basic %}
+Host:
+    description: "The IP address or hostname of your device."
+Port:
+    description: "The port number of the OpenWebif service running. (default: 80)."
+Username:
+    description: "The username, if HTTP(S) authentication is enabled."
+Password:
+    description: "The password, if HTTP(S) authentication is enabled."
+Uses an SSL certificate:
+    description: "Whether HTTPS is enabled."
+Verify SSL certificate:
+    description: "Whether the SSL certificate should be verified."
+{% endconfiguration_basic %}
+
+## Configuration options
+
+The integration provides the following configuration options:
+
+{% configuration_basic %}
+Turn off to deep standby:
+    description: "Shuts the device down (called Deep Standby) on turning off the device. **Important**: When the device is in *Deep Standby*, it can no longer be reached! Turning on the device is only possible via one of the following methods: Wake on LAN, Power button on the device, or the Remote control."
+Bouquet to use as media source:
+    description: "Sets the bouquet to use for the source list."
+{% endconfiguration_basic %}
+
+## Entities
+
+Currently, the following entity is exposed:
+
+### Media player
+
+The following actions are supported:
+
+- Play/Pause
+- Channel up and down (using the previous/next track buttons in the media player controls)
+- Volume control
+- Channel switching via source list
+
+The bouquet for the source list can be configured via the Configuration options.
+
+## Data updates
+
+This integration fetches data from the device every 15 seconds by default.
+
+## Troubleshooting
+
+### Getting a 403.6 IP address rejected error on setup
+
+#### Description
+
+OpenWebif has a protection by default, so that only devices in the same subnet can connect to the device.
+
+#### Resolution
+
+There are two possible solutions to resolve this problem:
+
+- Enable HTTP(S) authentication (recommended for security)
+- Enable the OpenWebif setting "Enable access from VPNs"
+
+{% note %}
+If you choose to enable VPN access without authentication, ensure your network is properly secured as OpenWebif is not designed for publicly facing the internet.
+{% endnote %}
+
+## Remove integration
+
+This integration follows standard integration removal, no extra steps are required.
+
+{% include integrations/remove_device_service.md %}