diff --git a/misc-scripts/xref_mapping/README b/misc-scripts/xref_mapping/README
index 7f6c8e010ae3fec8f9c7008a25a81d6aadf820ab..448a0b4370e3f2115f942c7cd1817fa9bc4c3588 100644
--- a/misc-scripts/xref_mapping/README
+++ b/misc-scripts/xref_mapping/README
@@ -1,3 +1,27 @@
+The Ensembl Xref System
+=======================
+
+
+Overview
+--------
+
+What is an xref
+---------------
+
+The xref holding database
+-------------------------
+
+Parsing xrefs
+-------------
+
+Mapping xrefs to Ensembl objects
+--------------------------------
+
+The Ensembl core schema xref tables
+-----------------------------------
+
+
+
 THe following is the initial first draft/initial mind dump which will be tidied
 up.