some info was leaky here, ship that off to private.py and clean up some docs