diff --git a/README b/README
deleted file mode 100644
index 0dc51c0..0000000
--- a/README
+++ /dev/null
@@ -1,9 +0,0 @@
-OE layer containing digital audio workstation and plugin recipes
-
-Most recipes formerly lived in [1]
-
-Layer dependencies are set in conf/layer.conf
-
-Layer maintainer: Andreas Müller <schnitzeltony@gmail.com>
-
-[1] https://github.com/schnitzeltony/meta-qt5-extra
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..91e9871
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+OE layer containing digital audio workstation and plugin recipes
+----------------------------------------------------------------
+
+
+Layer dependencies:
+----------------------
+see [layer.conf](conf/layer.conf) for dependencies and https://layers.openembedded.org/layerindex/branch/master/layers/ where to find layers
+
+
+Contributing
+------------
+* Submit any patches against the `meta-musicians` layer by using the GitHub pull-request feature.
+
+
+Policies
+--------
+* Please do not send private emails to maintainers. For questions/suggestions.. use GitHub issues.
+* Pull requests should follow [OE-Styleguide](https://www.openembedded.org/wiki/Styleguide) with the following additions:
+  * Use 4 spaces for indention always
+  * For splitting of long list values use four-space indentation on sucessive lines and prefer the closing quote as the first character ([OE-Styleguide](https://www.openembedded.org/wiki/Styleguide) - second example)
+  * Pull-requests with patches fixing issues for musl, clang or gold-linker are accepeted only with upstream-status "Applied" or "Backport"
+
+
+Maintainers
+-----------
+
+Layer maintainer: Andreas Müller <schnitzeltony@gmail.com>