Merge branch 'expand-migration-testing-docs' into 'master'

Provide extra detail on `table` in migration tests

See merge request gitlab-org/gitlab!48575

doc/development/testing_guide/testing_migrations_guide.md

@@ -75,8 +75,9 @@ require_migration!('populate_foo_column')
 
 Use the `table` helper to create a temporary `ActiveRecord::Base`-derived model
 for a table. [FactoryBot](best_practices.md#factories)
-**should not** be used to create data for migration specs. For example, to
-create a record in the `projects` table:
+**should not** be used to create data for migration specs because it relies on
+application code which can change after the migration has run, and cause the test
+to fail. For example, to create a record in the `projects` table:
 
 ```ruby
 project = table(:projects).create!(id: 1, name: 'gitlab1', path: 'gitlab1')