add links and cleanup README structure

.github/contributing.md

@@ -0,0 +1,30 @@
+# Contribution Guidelines
+
+Please note that this project is released with a [Contributor Code of Conduct](code-of-conduct.md). By participating in this project you agree to abide by its terms.
+
+## Adding an awesome list
+
+Please ensure your pull request adheres to the [list of guidelines](pull_request_template.md).
+
+## Creating your own awesome list
+
+To create your own list, check out the [instructions](create-list.md).
+
+## Adding something to an awesome list
+
+If you have something awesome to contribute to an awesome list, this is how you do it.
+
+You'll need a [GitHub account](https://github.com/join)!
+
+1. Access the awesome list's GitHub page. For example: https://github.com/sindresorhus/awesome
+2. Click on the `readme.md` file: ![Step 2 Click on Readme.md](https://cloud.githubusercontent.com/assets/170270/9402920/53a7e3ea-480c-11e5-9d81-aecf64be55eb.png)
+3. Now click on the edit icon. ![Step 3 - Click on Edit](https://cloud.githubusercontent.com/assets/170270/9402927/6506af22-480c-11e5-8c18-7ea823530099.png)
+4. You can start editing the text of the file in the in-browser editor. Make sure you follow the guidelines above. You can use [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/). ![Step 4 - Edit the file](https://cloud.githubusercontent.com/assets/170270/9402932/7301c3a0-480c-11e5-81f5-7e343b71674f.png)
+5. Say why you're proposing the changes, and then click on "Propose file change". ![Step 5 - Propose Changes](https://cloud.githubusercontent.com/assets/170270/9402937/7dd0652a-480c-11e5-9138-bd14244593d5.png)
+6. Submit the [pull request](https://help.github.com/articles/using-pull-requests/)!
+
+## Updating your Pull Request
+
+Sometimes, a maintainer of an awesome list will ask you to edit your Pull Request before it is included. This is normally due to spelling errors or because your PR didn't match the awesome-\* list guidelines.
+
+[Here](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md) is a write up on how to change a Pull Request and the different ways you can do that.

.github/pull-request-template.md

@@ -0,0 +1,33 @@
+# Awesome List Contribution
+
+## Description
+
+<!-- Provide a brief description of the contribution you are making to the Awesome List. -->
+
+## Added/Updated Section
+
+<!-- Specify the section of the Awesome List that you are adding to or updating. -->
+
+## What is Added/Updated
+
+<!-- Provide a concise summary of the new content you are adding or the updates you are making. -->
+
+## Link(s) to Resource(s)
+
+<!-- Include link(s) to the resources you are adding. -->
+
+## Additional Information
+
+<!-- Add any additional context or information that may be relevant to your contribution. -->
+
+## Checklist
+
+- [ ] I have read and followed the Awesome List contribution guidelines.
+- [ ] The resource(s) I am adding comply with the contribution guidelines.
+- [ ] I have checked for duplicate entries within the Awesome List.
+- [ ] My contribution follows the format/style of the existing content in the Awesome List.
+- [ ] I have tested any code snippets or examples provided (if applicable).
+
+## Screenshots (if applicable)
+
+<!-- Include screenshots or visual aids if they enhance your contribution. -->