api and docs tweaks prior to registration with PIP