diff --git a/README.md b/README.md
new file mode 100644
index 000000000..f210d3805
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+openbsc.git
+===========
+
+This is a HISTORICAL,OBSOLETE repository containing the code-base
+of what used to be known as bs11_hack, later OpenBSC and also OsmoNITB.
+
+Those projects have been superseded by OsmoBSC, OsmoMSC and OsmoHLR
+(collectively known as Osmocom CNI).
+
+The code in this repository is completely unmaintained, unsupported and
+it is strongly discouraged to use it.  On the other hand, the modern
+Osmocom CNI implementations are fully maintained and continuously
+tested.
+
+Do not bother the developers with questions about code from this
+repository.
+
+Further Links
+-------------
+
+* [New-style GSM NITB baesd on discrete Osmocom CNI projects](https://osmocom.org/projects/cellular-infrastructure/wiki/Osmocom_Network_In_The_Box)
+* [Migration guide from OsmoNITB to Osmcoom CNI](https://osmocom.org/projects/cellular-infrastructure/wiki/OsmoNITB_Migration_Guide)