update docs, add descriptions for api methods

docs/route.md

@@ -1,5 +1,6 @@
 # route(root, defaultRoute, routes)
 
+- [Description](#description)
 - [Signature](#signature)
 	- [Static members](#static-members)
 		- [route.set](#routeset)
@@ -21,6 +22,24 @@
 
 ---
 
+### Description
+
+Navigate between "pages" within an application
+
+```javascript
+var Home = {
+	view: function() {
+		return "Welcome"
+	}
+}
+
+m.route(document.body, "/home", {
+	"/home": Home, // defines `http://localhost/#!/home`
+})
+```
+
+---
+
 ### Signature
 
 `m.route(root, defaultRoute, routes)`