As evidenced and discussed in #2577 , generated files are not clearly explained in CONTRIBUTING.md and this should be improved, however, i phrase this issue in a more general way as to allow for discussion regarding the contents of this file and how we might improve them.