(#2547) - document schema migrations

Based on an IRC discussion today, I realized
people don't know that this feature exists.