Updated the styling and content in the README (#2202)

* Updated the styling and content in the README

* Update README.md

* Update CONTRIBUTING.md

* Update README.md

CONTRIBUTING.md

@@ -7,7 +7,13 @@ The repository contains all the languages that we have translations of our docum
 If you wish to contribute to our documentation you can do so as follows:
 
 #### Changes to English documents
-Submit a PR with your modifications **only to the `en` folder. Since the English folder is the 'master' one, any changes to the files under the `en` folder will be propagated to the other languages.
+Submit a PR with your modifications **only** to the `en/` folder. Since the English folder is the 'master' one, any changes to the files under the `en/` folder will be propagated to the other languages.
 
-#### Translations 
-You can start translating documentation in a language other than English that you speak. You can do so by joining our project in [Crowdin](https://crowdin.com) [here](https://crowdin.com/project/phalcon-documentation/)
+#### Translations
+You can start translating documentation in a language other than English that you speak. You can do so by joining our project in [Crowdin](https://crowdin.com) [here](https://crowdin.com/project/phalcon-documentation/)
+
+<p>
+    <a href="https://crowdin.com">
+        <img src="https://support.crowdin.com/assets/logos/crowdin-CollaborativeTranslationTool-logo.png" width="40%"/>
+    </a>
+</p>

README.md

@@ -1,25 +1,31 @@
-### Phalcon Framework - Docs
-
 <p align="center"><a href="https://docs.phalconphp.com" target="_blank">
     <img src="https://assets.phalconphp.com/phalcon/logo-transparent-phalcon-black.svg" height="100" alt="Phalcon"/>
 </a></p>
 
-<p align="center">
-    Hosting By:
-    <br />
-    <a href="https://www.netlify.com">
-        <img src="https://www.netlify.com/img/global/badges/netlify-color-accent.svg"/>
-    </a>
-</p>
+# Phalcon Framework - Documentation
 
-Any pull requests to this repository must target the `en/` folder. All the languages are handled by 
+<a href="https://www.netlify.com">
+    <img src="https://www.netlify.com/img/global/badges/netlify-color-accent.svg"/>
+</a>
 
+You can find our documentation project in Crowdin [here](https://crowdin.com/project/phalcon-documentation)
 
-<p align="center">
-    <a href="https://www.netlify.com">
-        <img src="https://support.crowdin.com/assets/logos/crowdin-CollaborativeTranslationTool-logo.png"/>
-    </a>
-</p>
+## Contributing 
 
-You can find our documentation project in Crowdin [here](https://crowdin.com/project/phalcon-documentation)
+Phalcon is an open source PHP framework. This repository holds our documentation, one branch per version.
 
+The repository contains all the languages that we have translations of our documentation for. The master language is English `en` and that is the only one that can be changed in this repository.
+
+If you wish to contribute to our documentation you can do so as follows:
+
+#### Changes to English documents
+Submit a PR with your modifications **only** to the `en/` folder. Since the English folder is the 'master' one, any changes to the files under the `en/` folder will be propagated to the other languages.
+
+#### Translations
+You can start translating documentation in a language other than English that you speak. You can do so by joining our project in [Crowdin](https://crowdin.com) [here](https://crowdin.com/project/phalcon-documentation/)
+
+<p>
+    <a href="https://crowdin.com">
+        <img src="https://support.crowdin.com/assets/logos/crowdin-CollaborativeTranslationTool-logo.png" width="40%"/>
+    </a>
+</p>