started on minimal docs to describe the design