Update README to link to reference where appropriate [ci skip]
fix syntax example in README [ci skip]