two more caveats described
Merge branch 'docs' of https://github.com/MichaelRFairhurst/wake-compiler into docs