Integrate kap/notes into docs

[jschwab]

The material in kap/notes is relatively old, but there's lots of good stuff in there, including some information about the preprocessors that isn't recorded elsewhere. We should integrate this into the main docs.