diff --git a/doc/Issues.md b/doc/Issues.md
new file mode 100644
index 000000000..20eacb11f
--- /dev/null
+++ b/doc/Issues.md
@@ -0,0 +1,9 @@
+# Issue usage
+
+We have an issue tracker on a seperate repository `stockholm-issues'
+installation is easy:
+  install gi (nix-shell -p gi)
+  in the stockholm root clone stockholm repo (gi clone git@prism:stockholm-issues)
+  now you can list issues with gi list
+
+check out the documentation: https://github.com/dspinellis/gi