Updated readme

README.md

@@ -1,35 +1,129 @@
-## OpenDroneMap Docs
+# OpenDroneMap Docs
 
-Documentation for [OpenDroneMap](https://github.com/OpenDroneMap/OpenDroneMap).
+Contribute to [OpenDroneMap](https://docs.opendronemap.org)'s documentation! Anyone is welcome to share their knowledge and improve our documentation. 🎉 And it's pretty simple too!
 
-## Development
+# "But I don't know if I can contribute"
 
-### Environment
+Even if you think your contribution might not be valuable, it might be for other users! If you discovered something remotely useful to you, it probably is very useful to others! :)
 
-_(on OSX)_
+Tips, tricks, hacks, datasets, lessons learned, best practices, every bit helps. We want to know! Share it.
+
+# How To Make Your First Contribution
+
+If you don't have a GitHub account, [register](https://github.com/join?source=header-home) first. It's free and GitHhub is awesome.
+
+Once you have an account there are two ways to contribute. One is quick for small changes, the second takes a bit longer to setup but makes writing long parts of documentation much quicker.
+
+# The Quick Method
+
+Simply browse to https://github.com/OpenDroneMap/docs/tree/publish/source and press one of the files. Each file corresponds to a page of the documentation. Press the "Edit" icon.
+
+![image](https://user-images.githubusercontent.com/1951843/54656313-78e26500-4a9b-11e9-9d7f-412bf7c36a2b.png)
+
+Make your changes, then select "Create a new branch for this commit and start a pull request". Complete the form that appears and wait for your changes to be approved! That's it!
+
+# The Pro Method
+
+For quick changes the method above is quick and fast. But if you want to write docs like a pro, in your own text editor of choice, follow these steps.
+
+Depending on your operating system, you should follow these steps to create a local copy of the documentation. This way you can modify and check the results before sending them for review.
+
+## Step 1. Make a Copy (fork) This Repository
+
+Press the "Fork" button at the top of this page.
+
+![image](https://user-images.githubusercontent.com/1951843/54656025-77fd0380-4a9a-11e9-82f6-35278ed9ccfc.png)
+
+## Step 2. Install Git and Python 3
+
+### Linux:
+
+```bash
+sudo apt-get install -y git python3`
+```
+
+### MacOS 
+
+We recommend to use [Brew](https://brew.sh/) for installing Python3.
 
 ```bash
-# install python
 brew install python3
-# install virtualenv
+```
+
+Git comes preinstalled on MacOS.
+
+### Windows
+
+Download Git from https://git-scm.com/download/win and Python 3 from https://www.python.org/downloads/windows/
+
+## Step 3. Make A Local Copy of The Documentation
+
+Open a Terminal (or a command prompt). In Windows you open a command prompt by pressing the Window Key and typing "Command Prompt" then Enter.
+
+Then run (replacing "yourusername" with your GitHub username):
+
+```bash
+git clone https://github.com/yourusername/docs
+```
+
+If it's your first time using git, also run:
+
+```
+git config --global user.name "Your Name"
+git config --global user.email "your@email.com"
+```
+
+With your information. So that we can credit the contributions to you.
+
+## Step 3. Get The Documentation Running
+
+From the same Terminal (or command prompt) run the following:
+
+```
+cd docs/
 pip install virtualenv
-# create Python environment
-virtualenv -p /usr/local/bin/python3 venv
-# open the Python environment
+virtualenv -p python3 venv
 source venv/bin/activate
-# install requirements
 pip install -r requirements.txt
 ```
 
-More on [`virtualenv`](https://virtualenv.pypa.io/en/stable/).
+Then if there are no errors, run:
 
-Use [`sphinx-autobuild`](https://github.com/GaretJax/sphinx-autobuild) to automatically watch for changes and rebuild the html site using:
 ```
 make livehtml
 ```
 
-To stop the server press `Ctrl+C`.
+Note that if WebODM is running you should temporarely stop it while you edit the documentation.
 
-### Travis-CI
+## Step 4. Start Editing
 
-Travis-CI docs for [Building a Python Project](https://docs.travis-ci.com/user/languages/python/) and [GitHub Pages Deployment](https://docs.travis-ci.com/user/deployment/pages/). Personal access token with 'public_repo - Access public repositories' permissions created and used it in `travis encrypt GH_TOKEN=my_github_token --add env.matrix` as described in the [Travis-CI docs](https://docs.travis-ci.com/user/environment-variables#Encrypting-environment-variables).
+You can now open a web browser to http://localhost:8000 and see the documentation!
+
+You can use a text editor to edit the .rst files in the "source" folder (for example, Visual Studio Code).
+
+As soon as you make a change to one of the files, your web browser will reload the documentation with the new changes!
+
+## Step 5. Publish Your Changes
+
+Open a Terminal (or command prompt) and type:
+
+```bash
+cd docs/
+git commit -a -m "A description of my changes"
+git push origin publish
+```
+
+You will be prompted for your GitHub credentials.
+
+## Step 6. Open a Pull Request
+
+Open https://github.com/OpenDroneMap/docs and you'll see a box asking you to open a pull request. Open a pull request by filling in a description of your changes and you're set! Somebody will review your changes and your contribution will be live on https://docs.opendronemap.org once approved.
+
+
+### Questions?
+
+Reach out to https://community.opendronemap.org, we'll help you get up and running with your first contribution if you get stuck!
+
+#### Repository Notes
+
+Travis-CI docs for [Building a Python Project](https://docs.travis-ci.com/user/languages/python/) and [GitHub Pages Deployment](https://docs.travis-ci.com/user/deployment/pages/). Personal access token with 'public_repo - Access public repositories' permissions created and used it in `travis encrypt GH_TOKEN=my_github_token --add env.matrix` as described in the [Travis-CI docs](https://docs.travis-ci.com/user/environment-variables#Encrypting-environment-variables).