1 files changed, 12 insertions, 0 deletions

diff --git a/doc_topics/02-development.md b/doc_topics/02-development.md
new file mode 100644
index 0000000..8925b83
--- /dev/null
+++ b/doc_topics/02-development.md
@@ -0,0 +1,12 @@
+# 2. Development
+
+Some tests cannot be run in CI becasue they test system specifics that
+simply do not exist in a CI environment. An example is the `isatty` function
+Which cannot be set to return a truthy value in CI.
+
+The tests concerned are all labelled with `#manual`. And in CI they will
+be skipped because `--exclude-tags=manual` is being passed to the
+`busted` command line.
+
+Hence if tests like this are being added, then please ensure the tests
+pass locally, and do not rely on CI only.