Write Migration Guide

Write a guide for moving from one major version to the next, listing each breaking change and its fix.

• write
• documentation