diff --git a/.github/workflows/readme.md b/.github/workflows/readme.md
new file mode 100644
index 00000000..f10be0cb
--- /dev/null
+++ b/.github/workflows/readme.md
@@ -0,0 +1,24 @@
+
+# main.yml 
+Reports to https://app.kosli.com
+The workflow to look in if you want to learn about Kosli.
+
+# main_staging.yml 
+Reports to https://staging.app.kosli.com
+A workflow for Kosli internal development purposes.
+When showing CI workflows in Kosli demos, there is a tension created
+by the fact that cyber-dojo Flows are unusual in that they need to 
+repeat every Kosli step twice; once to report to https://app.kosli.com
+and once again to report to https://staging.app.kosli.com
+A normal Kosli customer CI workflow yml file would only report to the former.
+To resolve this, a git push triggers the two workflows.
+
+This is basically the same as main.yml but it does NOT...
+- rebuild the docker image (since the build is not binary reproducible)
+- deploy the image to aws-beta/aws-prod (since main.yml already does that)
+It _does_ however re-run the test evidence so it is possible (eg if the unit-tests are flaky) 
+to get the run from main.yml to report a compliant Artifact and do deployments to aws-beta and 
+aws-prod but the run from main_staging.yml to report the same Artifact as non-compliant.
+In this situation, the Environment report for staging will see the Artifact deployment
+from 1)main.yml and so, in staging, the Artifact will appear as non-compliant in its snapshot.
+
diff --git a/docs/limit-text-file-count.txt b/docs/limit-text-file-count.txt
deleted file mode 100644
index 0807926a..00000000
--- a/docs/limit-text-file-count.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-
-Limit number of created text files returned to caller.
-At present there is no limit.
-Done for created files.
-Should it also be done for changed files?
diff --git a/docs/todo.txt b/docs/todo.txt
index 1dfd446e..4923ae4e 100644
--- a/docs/todo.txt
+++ b/docs/todo.txt
@@ -3,4 +3,11 @@ current test junit-output and coverage-output goes to test/server/reports/
 Split it into
 - test/server/report_junit
 - test/server/report_coverage
-So that we dont upload junit files in coverage kosli --attachment
\ No newline at end of file
+So that we don't upload junit files in coverage kosli --attachment
+
+
+Limit number of created text files returned to caller.
+At present there is no limit.
+Done for created files.
+Should it also be done for changed files?
+