From 529f46569748ae28713589441e91edf45695e0a7 Mon Sep 17 00:00:00 2001
From: "Walter F.J. Mueller" <w.f.j.mueller@gsi.de>
Date: Sun, 18 Dec 2016 14:13:02 +0100
Subject: [PATCH] add README.md

---
 README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..d1ca67d0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# w11: PDP 11/70 CPU and SoC
+
+### Overview
+The project contains the VHDL code for a **complete DEC PDP-11 system**:
+a PDP-11/70 CPU with memory management unit, but without floating point unit,
+a complete set of mass storage peripherals
+(RK11/RK05, RL11/RL02, RK70/RP06, TM11/TU10)
+and a basic set of UNIBUS peripherals
+(DL11, LP11, PC11),
+and last but not least a cache and memory controllers for SRAM and PSRAM.
+The design is **FPGA proven**, runs currently on
+Digilent Arty, Basys3, Nexys4, Nexys3, Nexys2 and S3board boards
+and boots 5th Edition UNIX and 2.11BSD UNIX. 
+
+For more information look into:
+* [w11 home page](https://wfjm.github.io/home/w11/)
+
+### Note on freecores/w11
+The [freecores team](http://freecores.github.io/) created in 2014 a
+copy of almost all OpenCores cores in Github under
+[freecores](https://github.com/freecores). This created
+[freecores/w11](https://github.com/freecores/w11)
+which is 
+[*outdated* and *not maintained*](https://github.com/freecores/w11/issues/1).
+***Only [wfjm/w11](https://github.com/wfjm/w11) is maintained***.