website/docs: clarify upgrade breakage is a bug