Upgrade guide

My friend @tukan noticed in his twitter that the upgrade guide for cap 3.x if missing. I've fixed that :)