exposed extension points now are slightly better documented