holy grail docs

 This layout is in a work in progress.