Merge pull request #37 from paultheastronomer/master

Added a two 'How to...' articles

Author: Vanessa McBride

How_the_toolkit_works.md

@@ -0,0 +1,17 @@
+How the toolkit works
+===================
+
+<p align="center"><img src="https://raw.githubusercontent.com/astro4dev/OAD-Data-Science-Toolkit/master/img/DST_logo_250px.png" alt="DST Logo"/></p>
+
+## Step 1 - Adding toolkit content
+The toolkit content is stored on the github servers under the <a href="https://github.com/astro4dev/OAD-Data-Science-Toolkit" target="_blank">OAD-Data-Science-Toolkit</a> repository. Content is added by individual contributors by first cloning the repository, making the changes, then creating a pull request. The astro4dev data science working group are automatically informed about the new pull request. The request is then verified before it is added to the main astro4dev repository.
+
+## Step 2 - Adding the content to the database
+
+Once the content has been uploaded to github it has to be added to the MySQL database. This is done by a member of the astro4dev data science working group. The database is composed of many tables which can be dividied into two groups.
+
+- Content Tables
+- Relational Tables
+
+### The content tables
+The content tables have one word names, e.g. _skills_.

How_to_upload_content.md

@@ -0,0 +1,62 @@
+How to upload content
+===================
+
+<p align="center"><img src="https://raw.githubusercontent.com/astro4dev/OAD-Data-Science-Toolkit/master/img/DST_logo_250px.png" alt="DST Logo"/></p>
+
+## 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>.
+
+
+
+
+

README.md

@@ -42,4 +42,4 @@ For more information on the OAD including current projects and how you can contr
 
 ## License
 <p><a href="http://www.gnu.org/licenses/gpl-3.0.html" target="_blank"><img src="https://www.gnu.org/graphics/gplv3-127x51.png"></a></p>
-Licensed under the <a href="http://www.gnu.org/licenses/gpl-3.0.html" target="_blank">GPLv3</a>.
+Licensed under the <a href="http://www.gnu.org/licenses/gpl-3.0.html" target="_blank">GPLv3</a>.

Teaching Materials/README.md

@@ -2,5 +2,3 @@ Teaching Materials
 ===================
 
 This part of the toolkit provides teaching materials which most of them utilise astronomy examples to teach data science techniques. You are welcome to use any of the materials as you see fit (in accorance with the <a href="https://www.gnu.org/copyleft/gpl.html" target="_blank">GPLv3 licence</a>), we ask that you give credit to the creator of the material.
-
-For an overview of the teaching materials have a look at our <a href="https://rawgit.com/astro4dev/OAD-Data-Science-Toolkit/master/Teaching%20Materials/overview.html" target="_blank">Data Science Toolkit Map</a>.