more design notes; formatting improvements
mojo generate
added a couple of routes we\'re going to need