Merge pull request #44 from paultheastronomer/master

Added info on how to contribute

Author: paultheastronomer

CONTRIBUTING.md

@@ -1 +1,69 @@
-To be added.
+Contributing to the Astronomy & Data Science Toolkit
+===================
+
+## Teaching materials
+If you have ever taught astronomy using data science techniques or you are a data scientist who has used astronomy examples to teach data science, please consider sharing your teaching materials. You can either directly contribute to github or send us the materials directly via email.
+
+## Assessments
+Few Astronomy summer schools and extra-curricular programmes use any form of assessment. This deprives students of the opportunity to both experience and demonstrate their achievements; and doesn't allow the ability to show others that they achieved what they intended. The toolkit strives towards providing high quality pre- and post-assessments.
+
+## Coding and Content
+This website has been created using a lot of different tools: HTML5, CSS3, PHP, MySQL, AJAX, jQuery, Shell, JavaScript and Python. If you have experience in any of these tools or perhaps would like to improve the content on this website please help contribute. The entire website can be found here.
+
+# How to upload content
+
+## Get a GitHub account
+
+It's required if you want to submit content to the toolkit which is hosted on GitHub. Get an account <a href="https://github.com/" target="_blank">here</a>.
+
+## Install git on your computer
+To use Git on the command line, you'll need to download, install, and configure Git on your computer.
+
+On Ubuntu
+```sh
+sudo apt-get install git
+```
+
+There is also a GUI interface known as the
+<a href="https://desktop.github.com/" target="_blank">Desktop version</a> which is available for Windows and for Mac OSX.
+
+## Fork a repository
+<a href="https://help.github.com/articles/fork-a-repo/" target="_blank">Instructions on GitHub</a>
+
+## Syncing a fork
+If you have previously forked the repository, but it is now 'out of date' you may wish to bring your fork up to date with the main repository. You can find instructions on how to sync a fork <a href="https://help.github.com/articles/syncing-a-fork/" target="_blank">here</a>.
+
+## Making changes
+
+Download all the latest changes to your local repository
+```sh
+git pull
+```
+
+Once you have made changes locally you can get an overview of the files you've alterned (relative to your online repository) by typing:
+```sh
+git status
+```
+Red coloured files means they have not been added. Green means they have.
+
+To push a file to your repository clone on github type in any directory (within the 
+OAD-Data-Science-Toolkit folder):
+```sh
+git add [name_of_file]
+```
+
+You then have to commit it (basically prepare it to be uploaded) by adding a comment describing what you did:
+```sh
+git commit -m 'I removed the bug causing...'
+```
+
+Finally push it to your online clone of the repository by typing:
+```sh
+git push
+```
+
+## Opening pull requests
+If you are hoping to contribute back to the original repository, you can send a request to the original author to pull your fork into their repository by submitting a <a href="https://help.github.com/articles/about-pull-requests/" target="_blank">pull request</a>.
+
+## Making the content available on the toolkit website
+Once the content is on github, sombody from the OAD Data Science Working Group will add the content to the website making it searchable. See [here](How_the_toolkit_works.md) for more info.