some more stuff inside COMMON.md
about half of chapter 2