- rework the migration doc sections
- small fixes in bulk docs