2 files changed, 32 insertions, 33 deletions

diff --git a/README b/README
deleted file mode 100644
index 9817851b..00000000
--- a/README
+++ /dev/null
@@ -1,33 +0,0 @@
-This layer depends on:
-
-URI: git://github.com/openembedded/oe-core.git
-branch: master
-revision: HEAD
-
-When building stuff like qtdeclarative, qtquick, qtwebkit, make sure that
-you have required PACKAGECONFIG options enabled in qtbase build, see qtbase.inc
-for detail.
-
-Send pull requests to openembedded-devel@lists.openembedded.org with '[meta-qt5]' in the subject'
-
-When sending single patches, please using something like:
-
-git send-email -M -1 --to openembedded-devel@lists.openembedded.org --subject-prefix='meta-qt5][PATCH'
-
-Change option '-1' to '-n' for n number of patches in series
-
-You are encouraged to fork the mirror on github[1] to share your
-patches. This is preferred for patch sets consisting of more than one
-patch. Other services like gitlab, repo.or.cz or self hosted setups
-are of course accepted as well, 'git fetch <remote>' works the same on
-all of them. We recommend github because it is free, easy to use, has
-been proven to be reliable and has a really good web GUI.
-
-1. https://github.com/meta-qt5/meta-qt5/
-
-meta-qt5 has Yocto Project Compatible status since 2013:
-https://www.yoctoproject.org/product/meta-qt5
-
-Main layer maintainers:
-  Martin 'JaMa' Jansa <martin.jansa@gmail.com>
-  Otavio Salvador <otavio@ossystems.com.br>
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..fe943211
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+Qt5 OpenEmbedded/Yocto Project layer
+====================================
+
+This layer depends on:
+
+URI: https://github.com/openembedded/openembedded-core
+branch: master
+revision: HEAD
+
+When building stuff like `qtdeclarative`, `qtquick`, `qtwebkit`, make
+sure that you have required `PACKAGECONFIG` options enabled in qtbase
+build, see `qtbase` recipe for detail.
+
+
+Contributing
+------------
+
+Please submit any patches against the `meta-qt5` layer by using the
+GitHub pull-request feature.  Fork the repo, make a branch, do the
+work, rebase from upstream, create the pull request, yada-yada.
+
+Maintainers
+-----------
+
+- Martin 'JaMa' Jansa <martin.jansa@gmail.com>
+- Otavio Salvador <otavio@ossystems.com.br>
+
+Yocto Project Compatible
+------------------------
+
+meta-qt5 has Yocto Project Compatible status since 2013:
+https://www.yoctoproject.org/product/meta-qt5