From 2678e6d00cfd48d4a3f37d0653ea7dead07564d1 Mon Sep 17 00:00:00 2001
From: johndmulhausen <johndylan@google.com>
Date: Thu, 11 Feb 2016 02:21:36 -0800
Subject: [PATCH] Update README.md

---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 66 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 405e270b6c3..cded680a08e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,66 @@
-# CreaturesInUnitards
-Kubernetes Documentation
+# Contributing to the Kubernetes Documentation and Website
+
+Welcome! We are very pleased you want to contribute to Kubernetes.
+
+You can click the "Fork" button in the upper-right area of the screen to create a copy of our site on your GitHub account called a "fork." Make any changes you want in your fork, and when you are ready to send those changes to us, go to the index page for your fork and click "New Pull Request" to let us know about it.
+
+If you want to see your changes staged without having to install anything locally,
+change your fork of our repo to be named:
+
+    YOUR_GITHUB_USERNAME.github.io
+
+Then, visit: [http://YOUR_GITHUB_USERNAME.github.io](http://YOUR_GITHUB_USERNAME.github.io)
+
+You should see a special-to-you version of the site. 
+
+## Running the site locally
+
+If you have files to upload, or just want to work offline, run the below commands to setup
+your environment for running GitHub pages locally. Then, any edits you make will be viewable
+on a lightweight webserver that runs on your local machine.
+
+First install rvm
+
+	\curl -sSL https://get.rvm.io | bash -s stable
+
+Then load it into your environment
+
+	source /Users/(USERNAME)/.rvm/scripts/rvm (or whatever is prompted by the installer)
+
+Then install Ruby 2.2 or higher
+
+	rvm install 2.2
+	rvm use 2.2 --default
+	
+Verify that this new version is running (optional)
+
+	which ruby
+	ruby -v
+	
+Install the GitHub Pages package, which includes Jekyll
+
+	gem install github-pages
+
+Clone our site
+
+	git clone https://github.com/kubernetes/kubernetes.github.io.git
+
+Then, see it run locally:
+
+	cd kubernetes.github.io
+	jekyll serve .
+
+Your copy of the site will then be viewable at: [http://0.0.0.0:4000](http://0.0.0.0:4000)
+(or wherever Ruby tells you).
+
+If you're a bit rusty with git/GitHub, you might wanna read
+[this](http://readwrite.com/2013/10/02/github-for-beginners-part-2) for a refresher.
+
+The above instructions work on Mac and Linux.
+[These instructions ](https://martinbuberl.com/blog/setup-jekyll-on-windows-and-host-it-on-github-pages/)
+might help for Windows users. 
+
+## Thank you!
+
+Kubernetes thrives on community participation and we really appreciate your
+contributions to our site and our documentation!