docs: добавь поясняющие комментарии к модулям и инструментам

python/set_devices/gas_logger.py

@@ -1,3 +1,7 @@
+# Клиент согласованных снимков GAS-регистратора и проверка карты сигналов. Скачивание
+# выполняется в рабочем потоке транспорта; записи с истёкшим ожиданием нельзя автоматически
+# повторять, поскольку устройство уже могло применить команду.
+
 """Experimental GAS recorder map and transport-independent snapshot client.
 
 read(address, count) -> words; write(address, value) must await a confirmed
@@ -84,7 +88,13 @@ def schema_id(mapping):
 def c_header(mapping):
     """Generate the checked-in C mirror; --check in CI catches drift."""
     validate_map(mapping)
-    lines = ['/* Generated from pm35.json. Do not edit. */',
+    lines = ['/*\n'
+             ' * Связь регистратора ПМ35 с картой доступных сигналов. Адреса сигналов согласуются с\n'
+             ' * JSON-картой клиента; изменение только одной стороны приводит к неверной интерпретации снимка\n'
+             ' * даже при успешном обмене.\n'
+             ' */\n'
+             '\n'
+             '/* Generated from pm35.json. Do not edit. */',
              '#ifndef GL_PM35_MAP_H', '#define GL_PM35_MAP_H', '#include "gas_logger.h"',
              'static const gl_channel gl_pm35_channels[] = {']
     for c in mapping['channels']: