readme: usage, stubs, api versioning