copy the first half of the Iris appendix into the repository, so that we can keep the documentation in sync