Update development instructions

Add section for running the site locally and update the instructions
for adding a new page

Closes: #44
Closes: #69

Author: sjaks

README.md

@@ -6,16 +6,34 @@ The repository uses Jekyll to generate HTML of the Markdown text files.
 
 ## Adding pages
 
-You can add new pages using included `bin/jekyll-page`
+You can add a new page by creating a new Markdown file inside of some of the collection directories under the `pages/` directory.
 
-For example add SSH page to get started
-```bash
-ruby bin/jekyll-page "Configure SSH" get-started
+The new page file should start with a header that includes the following information:
 ```
+---
+layout: page
+title: "My new help article"
+order: 1
+summary: "Description for my new help article"
+---
+
+Actual content...
+```
+
+Write the article following the Markdown syntax. You may want to refer to a [syntax guide](https://guides.github.com/features/mastering-markdown/).
+
+## Running locally
 
-## Building the pages
+You may want to preview your changes while writing an article or developing the site. You can run this Jekyll site locally if you have [Bundler and Jekyll installed](https://jekyllrb.com/docs/installation/).
+
+Install the gems and start the local server:
+```
+docs$ bundle config set path 'vendor/bundle'
+docs$ bundle install
+docs$ bundle exec jekyll serve
+```
 
-TODO
+The site is now accessible from http://127.0.0.1:4000/docs/.
 
 ## Publishing the pages