Update README.md

How it works, notes, field names etc...