diff --git a/firmware/integration/LiveData.yaml b/firmware/integration/LiveData.yaml
index db12f47cad..2033acca50 100644
--- a/firmware/integration/LiveData.yaml
+++ b/firmware/integration/LiveData.yaml
@@ -1,6 +1,12 @@
 #
 # here we have LiveData configuration file
-# see gen_live_documentation.sh
+# key: [NameOfJavaToGenerate.java, folder_where_key.txt_is located, (optional advanced options)]
+# Naming convention: top level struct in .txt file should be called key_s
+# todo: double-check if manual git add is requited or if (both) generated files are auto-added into git
+# at the moment new line would need to be added into StateDictionary manually todo: automate
+#
+# see gen_live_documentation.sh which is the main generation script
+# todo: what is sequence of events in terms of 'live_data_e' code generation?
 #
 Usages:
   output_channels: ["TsOutputs.java", "console/binary", "-prepend=integration/rusefi_config.txt" ]