docs
sketching out API