updated output nb to new format
some touching up of the docs
initial file structure for structured requests