bit more doc love, sketching out design overview :closed_book: