update README with details of current interactivity api - closes #38