Upgrade guide

Fixes #161.

Adds an upgrade guide for version 2.8 to 3.x. This documents only the specific issues I encountered during the upgrade. I'm sure there are more, so add them as needd.