Merge branch 'docs-restructure' into develop

docs/README.md

@@ -16,6 +16,8 @@ dart run build_runner serve web:8080 --live-reload
 To build the website into a directory `out`, use:
 
 ```
-dart run drift_dev schema steps lib/snippets/migrations/exported_eschema/ lib/database/schema_versions.dart
+dart run drift_dev schema steps lib/snippets/migrations/exported_eschema/ lib/snippets/migrations/schema_versions.dart
+dart run drift_dev schema generate --data-classes --companions lib/snippets/migrations/exported_eschema/ lib/snippets/migrations/tests/generated_migrations/
+
 dart run build_runner build --release --output web:out
 ```

docs/build.yaml

@@ -56,7 +56,9 @@ targets:
               version: "3.39"
         generate_for:
           include: &modular
+            - "lib/snippets/_shared/**"
             - "lib/snippets/modular/**"
+            - "lib/snippets/drift_files/custom_queries.*"
       drift_dev:modular:
         enabled: true
         options: *options
@@ -120,6 +122,8 @@ targets:
           environment: "preview"
       build_web_compilers:entrypoint:
         generate_for:
+          include:
+            - "web/**"
           exclude:
             - "web/drift_worker.dart"
         release_options:

docs/lib/snippets/_shared/todo_tables.dart

@@ -0,0 +1,26 @@
+import 'package:drift/drift.dart';
+import 'package:drift/internal/modular.dart';
+
+import 'todo_tables.drift.dart';
+
+// #docregion tables
+class TodoItems extends Table {
+  IntColumn get id => integer().autoIncrement()();
+  TextColumn get title => text().withLength(min: 6, max: 32)();
+  TextColumn get content => text().named('body')();
+  IntColumn get category => integer().nullable().references(Categories, #id)();
+}
+
+@DataClassName('Category')
+class Categories extends Table {
+  IntColumn get id => integer().autoIncrement()();
+  TextColumn get name => text()();
+}
+// #enddocregion tables
+
+class CanUseCommonTables extends ModularAccessor {
+  CanUseCommonTables(super.attachedDatabase);
+
+  $TodoItemsTable get todoItems => resultSet('todo_items');
+  $CategoriesTable get categories => resultSet('categories');
+}