diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..4589f96db57686dd518c88f814bf2a745b76bca1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# Example repository for the TDT4140 course, Spring 2018
+
+This repository contains templates and examples for the TDT4140 course, for Spring 2018. Currently, it contains two project, both using maven as build system and configured for using Eclipse:
+* [tdt4140-gr18nn](tdt4140-gr18nn/README.md]: Template for JavaFX project with two sub-modules, one for the model and one for the UI. To use the template, copy the whole structure and systematically rename files and edit file contents to match your group number.
+* [tdt4140-gr1800](tdt4140-gr1800/README.md]: Example project based on the template, and extended to include a web server module.
diff --git a/tdt4140-gr1800/README.md b/tdt4140-gr1800/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..083dd9f63a9ad0cfdd9b4231c00ad12deff42136
--- /dev/null
+++ b/tdt4140-gr1800/README.md
@@ -0,0 +1,3 @@
+# Example project for the TDT4140 course, Spring 2018
+
+This project is an example for Spring 2018, based on the [template project](../tdt4140-gr18nn/README.md]
diff --git a/tdt4140-gr18nn/README.md b/tdt4140-gr18nn/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..fb199a837bbb7c64ba6b8b8be4fac017ba46ca3b
--- /dev/null
+++ b/tdt4140-gr18nn/README.md
@@ -0,0 +1,3 @@
+# Template project for the TDT4140 course, Spring 2018
+
+This is a template for a JavaFX project with two sub-modules, one for the model and one for the UI. To use the template, copy the whole structure and systematically rename files and edit file contents to match your group number.