Tweak README limitations paragraph.
Rename spec to schema.
Flesh out example more.