prepare 2.2.0 release

[mbjones]

Release tasks include:

• Update versions everywhere
• Update documentation for 2.2 changes
• Move documentation into markdown for better display on GitHub
• rework doc build process to use these markdown files
• ensure tests and CI systems all pass