document API in README for now at least, for #3