refactor(migration): update documentation and remove ignored lint

- Remove comment_references lint ignore
- Update migration documentation to use prDate and prSummary instead of version and description

Author: fulleni

lib/src/database/migration.dart

@@ -1,14 +1,12 @@
-// ignore_for_file: comment_references
-
 import 'package:logging/logging.dart';
 import 'package:mongo_dart/mongo_dart.dart';
 
 /// {@template migration}
 /// An abstract base class for defining database migration scripts.
 ///
 /// Each concrete migration must extend this class and implement the [up] and
-/// [down] methods. Migrations are identified by a unique [version] string
-/// (following the `YYYYMMDDHHMMSS` format) and a [description].
+/// [down] methods. Migrations are identified by a unique [prDate] string
+/// (following the `YYYYMMDDHHMMSS` format) and a [prSummary].
 ///
 /// Implementations of [up] and [down] must be **idempotent**, meaning they
 /// can be safely run multiple times without causing errors or incorrect data.