2 files changed, 56 insertions, 13 deletions
diff --git a/README b/README
deleted file mode 100644
@@ -1,13 +0,0 @@
-(C) 2010 by Harald Welte <firstname.lastname@example.org>
-SIMTRACE is a program that can be used for tracing the communication
-betewen a phone and the SIM card. More generally, it can trace any
-ISO 7816 based smart card interface.
-This repository contains a host program 'simtrace' as well as a patch
-The corresponding device firmware can be found in the openpcd.git
-repository on git.gnumonks.org.
diff --git a/README.md b/README.md
new file mode 100644
@@ -0,0 +1,56 @@
+# Osmocom SIMtrace
+(C) 2010-2017 by Harald Welte <email@example.com>
+SIMTtraceis a program that can be used for tracing the communication
+between a phone and the SIM card. More generally, it can trace any
+ISO 7816 based smart card interface.
+SIMtrace is part of the [Osmocom](https://osmocom.org/) Open Source
+Mobile Communications project.
+This repository contains a host program 'simtrace' as well as a patch
+for wireshark (which is part of mainline wireshark since February 2012)
+The corresponding device firmware source code can be found at
+The official homepage of the project is
+You can clone from the official simtrace.git repository using
+ git clone git://git.osmocom.org/simtrace.git
+There is a cgit interface at <http://git.osmocom.org/simtrace/>
+There is a PDF user manual available from
+Discussions related to simtrace are happening on the
+firstname.lastname@example.org mailing list, please see
+<https://lists.osmocom.org/mailman/listinfo/simtrace> for subscription
+options and the list archive.
+Please observe the [Osmocom Mailing List
+Our coding standards are described at
+We us a e-mail based patch submission/review process on the
+above-mentioned mailing list for contributions.