We use mkdocs to convert markdown to this beautiful guide. It's really simple to start.

# Let's assume you've already installed python on your box
# Python and pip are in your PATH environment variable
git clone http://github.com/codito/vso-deploy-guide.git vso-deploy-guide

cd vso-deploy-guide

pip install -r requirements.txt

mkdocs serve

Now browse to http://127.0.0.1:8000. You'll see a local version of this guide. Open your favorite editor and write away. Any changes will automatically reflect on the local server.

Once you're happy about the changes, create a pull request in github. Let's spread the love together!