diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 000000000..bec379e13
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,51 @@
+======================
+Contributing to Murano
+======================
+
+If you're interested in contributing to the Murano project,
+the following will help get you started.
+
+Contributor License Agreement
+=============================
+
+In order to contribute to the Murano project, you need to have
+signed OpenStack's contributor's agreement:
+
+* http://docs.openstack.org/infra/manual/developers.html
+* http://wiki.openstack.org/CLA
+
+
+Project Hosting Details
+=======================
+
+* Bug tracker
+    * https://launchpad.net/murano
+
+    * https://launchpad.net/python-muranoclient
+
+* Mailing list (prefix subjects with ``[Murano]`` for faster responses)
+    http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
+
+* Wiki
+    https://wiki.openstack.org/wiki/Murano
+
+* IRC channel
+    * #murano at FreeNode
+
+    * https://wiki.openstack.org/wiki/Meetings#Murano_meeting
+
+* Code Hosting
+    * https://git.openstack.org/cgit/openstack/murano
+
+    * https://git.openstack.org/cgit/openstack/murano-agent
+
+    * https://git.openstack.org/cgit/openstack/murano-dashboard
+
+    * https://git.openstack.org/cgit/openstack/python-muranoclient
+
+    * https://git.openstack.org/cgit/openstack/murano-apps
+
+* Code Review
+    * https://review.openstack.org/#/q/murano+AND+status:+open,n,z
+
+    * http://docs.openstack.org/infra/manual/developers.html#development-workflow
diff --git a/HACKING.rst b/HACKING.rst
new file mode 100644
index 000000000..7e717ebb7
--- /dev/null
+++ b/HACKING.rst
@@ -0,0 +1,11 @@
+Murano Dashboard Style Commandments
+===================================
+
+*- Step 1: Read the OpenStack Style Commandments
+  http://docs.openstack.org/developer/hacking/
+
+* Step 2: Read [hacking] section in tox.ini to find the list of names which
+  can be imported directly without triggering the "H302: import only modules"
+  flake8 warning
+
+* Step 3: Read on
diff --git a/README.rst b/README.rst
index af379fc67..1ab654d9a 100644
--- a/README.rst
+++ b/README.rst
@@ -1,43 +1,28 @@
 Murano
 ======
+
 Murano Project introduces an application catalog, which allows application
 developers and cloud administrators to publish various cloud-ready
-applications in a browsable categorised catalog, which may be used by the
-cloud users (including the inexperienced ones) to pick-up the needed
-applications and services and composes the reliable environments out of them
-in a "push-the-button" manner.
+applications in a browsable‎ categorised catalog. Cloud users
+— including inexperienced ones — can then use the catalog to
+compose reliable application environments with the push of a button.
 
-murano-dashboard
+Murano Dashboard
 ----------------
-murano-dashboard is an extension for OpenStack Dashboard that provides UI for
+Murano Dashboard an extension for OpenStack Dashboard that provides UI for
 Murano. With murano-dashboard user is able to easily manage and control
 application catalog, running applications and created environments alongside
 with all other OpenStack resources.
 
 For developer purpose, please place OpenStack Dashboard extension file, located
 at *local/_50_murano.py* under horizon/openstack_dashboard/local/enabled
-directory and run horizon as usually.
+directory and run horizon as usual.
 
 Project Resources
 -----------------
-* `Murano at Launchpad <http://launchpad.net/murano>`__
-* `Wiki <https://wiki.openstack.org/wiki/Murano>`__
-* `Code Review <https://review.openstack.org/>`__
-* `Sources <https://wiki.openstack.org/wiki/Murano/SourceCode>`__
-* `Developers Guide <http://murano-docs.github.io/latest/developers-guide/content/ch02.html>`__
 
-How To Participate
-------------------
-If you would like to ask some questions or make proposals, feel free to reach
-us on #murano IRC channel at FreeNode. Typically somebody from our team will
-be online at IRC from 6:00 to 20:00 UTC. You can also contact Murano community
-directly by openstack-dev@lists.openstack.org adding [Murano] to a subject.
-
-We’re holding public weekly meetings on Tuesdays at 17:00 UTC
-on #openstack-meeting-alt IRC channel at FreeNode.
-
-If you want to contribute either to docs or to code, simply send us change
-request via `gerrit <https://review.openstack.org/>`__.
-You can `file bugs <https://bugs.launchpad.net/murano/+filebug>`__ and
-`register blueprints <https://blueprints.launchpad.net/murano/+addspec>`__ on
-Launchpad.
+* `Murano at Launchpad <http://launchpad.net/murano>`_
+* `Wiki <https://wiki.openstack.org/wiki/Murano>`_
+* `Code Review <https://review.openstack.org/>`_
+* `Sources <https://wiki.openstack.org/wiki/Murano/SourceCode>`_
+* `Documentation <http://murano.readthedocs.org/>`_