Merge pull request #10 from mapzen/add-workshop-recap

Add section for the workshop overview and resources

Author: rmglennon

README.md

@@ -1,13 +1,46 @@
 # Write the Docs SF workshop
 
-Files for the GitHub for Documentation workshop for Write the Docs - San Francisco. 
+This repository contains the files used in the GitHub for Documentation workshop from [Write the Docs - San Francisco](https://www.meetup.com/Write-the-Docs-SF/events/234679051/) on October 27, 2016.
 
-https://www.meetup.com/Write-the-Docs-SF/events/234679051/
+Presenter: Rhonda Glennon, [@rmglennon](https://github.com/rmglennon)
 
-To work through the tutorial, start with [tutorial-learn-github-pages.md](tutorial-learn-github-pages.md).
+To work through the tutorial presented in the workshop, start with [tutorial-learn-github-pages.md](tutorial-learn-github-pages.md).
 
-Presented on October 27, 2016
+## Workshop summary: GitHub for Documentation
 
-Rhonda Glennon
+GitHub enables people to collaborate on projects, and many organizations use it for managing both software code and documentation. At this Write the Docs, you will get started with GitHub by applying its tools to building a documentation website.
 
-@rmglennon
+In this hands-on workshop, you will:
+
+- Get an introduction to the Git version control system, terminology, and the GitHub workflow. 
+- Create a simple website with GitHub Pages and use GitHub for documentation. 
+- Learn how you can support open-source projects by contributing documentation.
+
+The session is designed for beginners to GitHub, but all levels are invited.
+
+Bring your laptop so you can follow along with the presentation. Any operating system will work, and you need only a browser. If you are new to GitHub, create a free, personal account at https://github.com/join before arriving to save time.
+
+## Resources from the presentation
+
+Examples of github.io websites
+
+- https://square.github.io/
+- https://microsoft.github.io/
+- https://disney.github.io/
+
+Markdown syntax reference
+
+- https://daringfireball.net/projects/markdown/
+
+Training classes from GitHub
+
+- https://services.github.com/training/
+- Includes free self-paced classes and webinars
+
+Examples of documentation repositories
+
+- CircleCI has a repository with only documentation-related files: https://github.com/circleci/circleci-docs
+- Kubernetes repository contains both code and documentation files: https://github.com/kubernetes/kubernetes
+- Example pull request about documentation with team discussion: https://github.com/pelias/pelias-doc/pull/163
+
+Make four pull requests by October 31, 2016 and get a free Hacktoberfest t-shirt: https://hacktoberfest.digitalocean.com/