Change to use short array syntax in migrations

- Add some missing doc comments
- Fix some casing issues in doc comments