document the v3 api in the readme, to base the lib on