holy grail docs

 This layout is a work in progress.