diff --git a/drift_dev/lib/src/writer/schema_version_writer.dart b/drift_dev/lib/src/writer/schema_version_writer.dart
index 3c8529c2..c6856a6b 100644
--- a/drift_dev/lib/src/writer/schema_version_writer.dart
+++ b/drift_dev/lib/src/writer/schema_version_writer.dart
@@ -325,6 +325,9 @@ class SchemaVersionWriter {
       final versionClass = '_S$versionNo';
       final versionScope = libraryScope.child();
 
+      // Reserve all the names already in use in [VersionedSchema] and its
+      // superclasses. Without this certain table names would cause us to
+      // generate invalid code.
       versionScope.reserveNames([
         'database',
         'entities',