What was unclear or otherwise insufficient?
Documentation around migrations is split between two pages:
Recommended Fix
Since this is quite confusing I would propose merging migration elements from using-cli into migrations.
Additional Context
No response
Are you willing to resolve this issue by submitting a Pull Request?
Yes, I have the time, and I know how to start.