various tidyups

packages/internet_traffic.yaml

@@ -1,3 +1,28 @@
+#:########################################################################################:#
+# Package: Internet Traffic Summary
+# File:    internet_traffic.yaml
+# Version: v1.2.0
+# Date:    2026-07-22
+#
+# Purpose:
+#   Preserves the household Internet download, upload, and total traffic sensors
+#   while sourcing current WAN rates from the EdgeRouter SNMP package.
+#
+# Behaviour:
+#   - Mirrors the EdgeRouter WAN download and upload rates in kB/s.
+#   - Calculates total traffic as the sum of download and upload rates.
+#   - Marks each sensor unavailable when its required source is unavailable.
+#
+# Dependency:
+#   - packages/edgerouter_snmp.yaml
+#
+# Version History:
+#   - v1.2.0 (2026-07-22): Migrated source data from EdgeOS attributes to the
+#     EdgeRouter SNMP WAN rate sensors and added availability handling.
+#   - v1.1.0 (2025-12-21): Migrated the three sensors to modern template syntax.
+#   - v1.0.0 (2022-10-12): Added the initial EdgeOS-based traffic sensors.
+#:########################################################################################:#
+
 template:
   - sensor:
       - name: "Internet Download Traffic"