Add notes about upgrading from 1.x

Links aren't reasonable to make at this point in time, as sphinx can't
easily make links and I'd rather not hardcode URLs.

Refs #3719