Merging with recipes docs

README.md

@@ -24,14 +24,39 @@ open `index.html` when following a link to a directory:
     $ cd html
     $ python3 -m http.server -b localhost 8000 &
 
-## Contribution Guide
-
-### Screenshots
+## Contributing to the Screenshots Section
 
 To contribute with Screenshots:
-* Add your image to the folder images/screenshots with an appropiated name.
-* Add a new <figure> tag in the bottom of *screenshots.mdwn*,
-* Inside the new tag, add the screenshots with a <img> tag and use the <figcaption> to add caption to the image, explaining what is being used on the screenshot.
+1. Add your image to the folder images/screenshots with an appropiated name.
+2. Add a new <figure> tag in the bottom of *screenshots.mdwn*,
+3. Inside the new tag, add the screenshots with a <img> tag and use the <figcaption> to add caption to the image, explaining what is being used on the screenshot.
+
+## Contributing to Recipes Section
+
+1. Fork this repository and create a new branch with a name relevant to the information you will be adding to the site.
+If you have doubts in how to Fork and Branch, take a look in this cheat-sheet [here](https://www.git-tower.com/blog/git-cheat-sheet/)
+
+The process of editing files can be done inside GitHub's interface, more information [here](https://help.github.com/articles/github-flow/)
+
+#### With external Link
+
+1. Create a new link in markdown format `[Link Name](Real Link)` in the appropiated section in `recipes.mdwn` file.
+
+#### With internal Link (host in awesome site)
+
+1. Create a new page with your tutorial/setup/widget/snippet in Markdown, with a relevant name, under the `recipes` folder.
+
+   - Example `recipes/xrandr-tutorial.mdmw`
+
+2. Link your page to the right section in the `recipes.mdwn` page with Markdown syntax.
+
+   - Example `[XrandR Tutorial](../recipes/xrandr-tutorial.html)`
+
+#### Seeing results and pulling your changes
+
+1. Build the site as explaining in the Hacking section in this same page to check how your changes will looks like.
+
+2. If everything is right and looks good, you're ready do make a Pull Request.
 
 ## Publishing
 

recipes.mdwn

@@ -2,6 +2,10 @@
 
 The recipes section is where you can find useful snippets and tutorials on how to improve your Awesome setup.
 
+* [How to contribute to Recipes](https://github.com/awesomeWM/awesome-www#contributing-to-recipes-section)
+
+## Setups
+
 * [My First Awesome Setup](https://awesomewm.org/apidoc/documentation/07-my-first-awesome.md.html#)
 
 ## Widgets