diff --git a/db/docs/ar_internal_metadata.yml b/db/docs/ar_internal_metadata.yml
index c25904a3a1b0717126be4e1d530ecd27abc43a81..e299e9f6317644413516aafb500809c7fba06ce6 100644
--- a/db/docs/ar_internal_metadata.yml
+++ b/db/docs/ar_internal_metadata.yml
@@ -3,6 +3,7 @@ table_name: ar_internal_metadata
 classes: []
 feature_categories:
 - database
-description: TODO
-introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/commit/9af97ee69a36de1dc4e73f4030d6316d3f0a82c5
-milestone: '13.0'
+description: >-
+  An internal table used by ActiveRecord to store information about how the database was migrated.
+introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/commit/9ba1224867665844b117fa037e1465bb706b3685
+milestone: '0.8'
diff --git a/db/docs/schema_migrations.yml b/db/docs/schema_migrations.yml
index f09cdb7bb532d7813aa6ad131bda6b30e54db7b8..a8df9b8a76771d2927d99b1ea045c2293e10e82b 100644
--- a/db/docs/schema_migrations.yml
+++ b/db/docs/schema_migrations.yml
@@ -5,6 +5,7 @@ classes:
 - Geo::TrackingBase::SchemaMigration
 feature_categories:
 - database
-description: TODO
-introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/commit/9af97ee69a36de1dc4e73f4030d6316d3f0a82c5
-milestone: '13.0'
+description: >-
+  An internal table used by ActiveRecord to keep track of which migrations have been applied to the database.
+introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/commit/9ba1224867665844b117fa037e1465bb706b3685
+milestone: '0.8'