diff --git a/README.md b/README.md
index e4db882..bfa486e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,21 @@
 # BCG101
-101 BASIC Computer Games
+101 BASIC Computer Games from the 1975 3rd print of DEC book.
+
+### Contents
+
+* dec: all source code from the book, proofread to include bugs, typos, odd
+spellings and formatting.
+
+* port: listings after quick port to TSS8 EduSystem 50 BASIC.
+
+* factory: refactoring of some of the TSS8 ported version.
+
+* expect: script used to upload the source to the emulated TSS8 over telnet.
+
+### Warnings
+
+* This predates the 1978 Microcomputer edition from Creative Computing and
+includes some games that have been dropped in the later edition.
+
+* Several dialects and styles of BASIC programming are used, some may trigger
+strong reactions if you suffer from BASIC allergy.