errata and clarification of 4663bfe5
put errata in the right order
update CONTRIBUTING.md