documentation: initial outline

Currently this is just an outline - like to get any comments first, and then we can flesh it out