Update the new schema appendix to include notes. Change formatting to not use docbook...