diff --git a/README.md b/README.md
index ed66b26..13407d5 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,20 @@ Utils to use openMSX in build pipelines.
 You can use these scripts as-is. But as always, feel free to extend it
 for your specific needs or contribute a fix or feature.
 
+## OpenMSX missing automation documentation
+
+* Don't use DirAsDisk, it is slow
+* Wrap all TCL commands in catch+stderr+exit1
+* Use TCL script for auto HD import/export
+* Use stdio mode for headless and/or fast boot
+* Disable throttling for automation steps
+* Use fail_after TCL script to run openMSX safely
+* Control openMSX from inside with TCL+command
+* Enable SDL just before command is addictive fast
+* TODO: Use TCL for BASIC/ASM/C lcov (Cobertura) code coverage
+
+The files in this repro try to handle these steps for you.
+
 ## Features
 
 * SDCC msx build steps.
@@ -79,3 +93,5 @@ Current set is WIP.
 * Doesn't work on windows
 * Missing dos1 support
 * Missing c support
+* If no SDL than screenshot in fail_after doesn't work
+