updated readme.md with layout info
# Mahout Instructions
-![Mahout](https://apache.mahout.org)
+![Mahout Logo]({{ ASSET_BASE }}/img/mahout-logo.png)
## How do I edit Mahouts website? Jekyll
@@ -39,13 +39,58 @@ Start coding.
## Organization
website/_site : this directory holds your static website. don't modify anything in here directly!
website/_pages : this directory holds most of the website content (more documentation to come)
-website/_posts : this directory holds the posts that populate the homepage ..
+website/_layouts : this directory holds the basic layouts for page types
website/assets : this directory holds the css and images used for the website
-## How to port a page .. TBD
+#### Themes
+With Jekyll Builder we can easily swap out themes. Currently the theme is `mahout`
+`website/_includes/themes/mahout` : This directory has HTML for things you will include in your pages, e.g. navbar
+`website/assets/themes/mahout` : this directory holds the css and images used for the website (on the mahout theme, if we also may build new themes to try different looks and feels)
+
+## How to port a page
+
+#### Copy to it's new home
+
+There should be no chnages to `/website/docs/0.13.0/` Need to create `/website/docs/0.13.1-SNAPSHOT/`
+
+Other non-docs, e.g. things that go in developers or other static places, should go to where ever it is they are supposed to live.
+
+If appropriate, change the file suffix from `.mdtext` or whatever wierd thing it is to `.md`
+
+#### Change the Header
+
+Most of the old stuff has a title like:
+
+`Title: GSOC`
+
+Change this too:
+
+```
+---
+layout: default
+title: GSoC
+theme: mahout
+---
+```
+
+#### Update PATHs where appropriate
+
+Change hard linkes or relative links like this
+```
+For more information see [Handling GitHub PRs](http://mahout.apache.org/developers/github.html)
+```
+
+To utilize JB's `{{ BASE_PATH }}`
+
+E.g.
+```
+For more information see [Handling GitHub PRs]({{ BASE_PATH }}/developers/github.html)
+```
+
+This will make links in say github, refer to the github links. Same with images.
