First cut of user guides, mainly ported from scaladoc.
Added some text to user guides index, and link one page to the other in user guides.