fix(docs): create initial data scripts page

app/data/migrations/0001_programarea_seed.py

@@ -3,7 +3,7 @@
 from core.models import ProgramArea
 
 
-def run(__code__, __reverse_code__):
+def forward(__code__, __reverse_code__):
     items = [
         (1, "Citizen Engagement"),
         (2, "Civic Tech Infrastructure"),
@@ -19,8 +19,11 @@ def run(__code__, __reverse_code__):
         ProgramArea.objects.create(uuid=uuid, name=name)
 
 
+def reverse(__code__, __reverse_code__):
+    ProgramArea.objects.all().delete()
+
+
 class Migration(migrations.Migration):
-    initial = True
     dependencies = [("core", "0018_rename_recurringevent_event")]
 
-    operations = [migrations.RunPython(run, migrations.RunPython.noop)]
+    operations = [migrations.RunPython(forward, reverse)]

app/data/migrations/0002_practicearea_seed.py

@@ -2,7 +2,7 @@
 from core.models import PracticeArea
 
 
-def run(__code__, __reverse_code__):
+def forward(__code__, __reverse_code__):
     items = [
         (1, "Development"),
         (2, "Project Management"),
@@ -13,8 +13,11 @@ def run(__code__, __reverse_code__):
         PracticeArea.objects.create(uuid=uuid, name=name)
 
 
+def reverse(__code__, __reverse_code__):
+    PracticeArea.objects.all().delete()
+
+
 class Migration(migrations.Migration):
-    initial = True
     dependencies = [("data", "0001_programarea_seed")]
 
-    operations = [migrations.RunPython(run, migrations.RunPython.noop)]
+    operations = [migrations.RunPython(forward, reverse)]

app/data/migrations/0003_sdg_seed.py

@@ -3,7 +3,7 @@
 from core.models import Sdg
 
 
-def run(__code__, __reverse_code__):
+def forward(__code__, __reverse_code__):
     items = [
         (1, "No Poverty", "End poverty in all its forms everywhere", "sdg01.png"),
         (
@@ -107,8 +107,11 @@ def run(__code__, __reverse_code__):
         Sdg.objects.create(uuid=uuid, name=name, description=description, image=image)
 
 
+def reverse(__code__, __reverse_code__):
+    Sdg.objects.all().delete()
+
+
 class Migration(migrations.Migration):
-    initial = True
     dependencies = [("data", "0002_practicearea_seed")]
 
-    operations = [migrations.RunPython(run, migrations.RunPython.noop)]
+    operations = [migrations.RunPython(forward, reverse)]

docs/how-to/create-initial-data-migrations.md

@@ -89,18 +89,20 @@ It is required that there be data in the first column of the sheet.
     from core.models import ModelNameInPascalCase
 
 
-    def run(__code__, __reverse_code__):
+    def forward(__code__, __reverse_code__):
         # paste everything in seed script's run function here
         # remove pass below
         pass
 
 
+    def reverse(__code__, __reverse_code__):
+        ModelNameInPascalCase.objects.all().delete()
+
+
     class Migration(migrations.Migration):
-        initial = True
         dependencies = [("data", "<name of last script, or contents of max_migration.txt>")]
 
-
-    operations = [migrations.RunPython(run, migrations.RunPython.noop)]
+        operations = [migrations.RunPython(forward, reverse)]
     ```
 
     For example:
@@ -111,7 +113,7 @@ It is required that there be data in the first column of the sheet.
     from core.models import BookType
 
 
-    def run(__code__, __reverse_code__):
+    def forward(__code__, __reverse_code__):
         items = [
             (1, "Hard Cover"),
             (2, "Soft Cover"),
@@ -120,12 +122,14 @@ It is required that there be data in the first column of the sheet.
             BookType.objects.create(uuid=uuid, name=name)
 
 
+    def reverse(__code__, __reverse_code__):
+        BookType.objects.all().delete()
+
+
     class Migration(migrations.Migration):
-        initial = True
         dependencies = [("data", "0011_author_seed")]
 
-
-    operations = [migrations.RunPython(run, migrations.RunPython.noop)]
+        operations = [migrations.RunPython(forward, reverse)]
     ```
 
 [pd-data-spreadsheet]: https://docs.google.com/spreadsheets/d/1x_zZ8JLS2hO-zG0jUocOJmX16jh-DF5dccrd_OEGNZ0/