diff --git a/README.md b/README.md
index e69de29..44bc682 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,22 @@
+# 8080-Assembler examples
+
+This is a collection of example programs and routines, for programming in
+8080-Assembler on C/PM 80. This code is meant to be run on a Z80-MBC2
+microcomputer, but can also run on any other 8080/8080 or Z80 machine, that runs
+CP/M 2.2. The code in these examples only uses iNTEL 8080 Mnemonics, in order to
+be compatible with CP/Ms built-in assembler. Some examples, however, require an
+extended VT100-Terminal, that can draw graphic-primitives via escape sequences.
+These examples will not work on a computer, that doesn't support them! The
+terminal used is Geoff Graham's
+[ASCII Video Terminal](https://geoffg.net/terminal.html), which is VT100
+compatible, but also supports the graphics extensions.
+
+The following example programs exist in the folder ./src
+
+- `HELLO.ASM`: A simple "Hello World" program, that uses the print screen
+  routine, calling BDOS.
+- `GRAPHTST.ASM`: Tests simple escape sequences, such as clearing the screen.
+- `CIRCLE.ASM`: Draws a circle on the screen, by printing the escape sequences
+  on the screen.
+- `MANDEL.ASM`: Uses graphic primitives to draw the
+  [Mandelbrot set](https://en.wikipedia.org/wiki/Mandelbrot_set) to the screen.