Fist pass with minor fixes

- Add some text about OA compatibility (needs it's own section)
- Fixup some examples