diff --git a/README.md b/README.md
new file mode 100644
index 0000000..08b15eb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# DSP Notes
+
+## Instruction
+
+- create a branch
+- add your notes to a thematic folder.
+- remember to update the `index.md` file to include new files
+
+## Markdown reference
+
+- [on GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) 
+- [a cheatsheet](https://www.markdownguide.org/cheat-sheet/)
+
+## Template reference
+
+- find instructions how to create your own technical documentation site using a GitHub template
+    at [biosustain/notes_template](https://github.com/biosustain/notes_template)