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

python/tests/test_altera_logic.py

@@ -1,3 +1,12 @@
+# Проверки altera_logic: фиксируют ожидаемое поведение на воспроизводимых входных данных.
+# Сценарии для навигации по файлу:
+#   test_rtl_info_and_first_configuration_vector
+#   test_error_response_is_short_even_for_info
+#   test_partial_response_times_out_without_retry
+#   test_demo_export_uses_capture_rate_not_current_ui_settings
+# Тестовые значения и подмены окружения относятся к проверке контракта; они не являются
+# настройками рабочего устройства.
+
 """Golden RTL vectors through the Python FFI (no Python production codec)."""
 import tempfile
 import unittest