Update README.md for conventions and 3.1 API