Editorial suggestions

Co-authored-by: sarayourfriend <[email protected]>

api/api/models/audio.py

@@ -254,7 +254,7 @@ class Meta(AbstractMedia.Meta):
 
 class DeletedAudio(AbstractDeletedMedia):
     """
-    Represents audio tracks that have been deleted from the source.
+    Represents audio tracks deleted from the upstream source.
 
     Do not create instances of this model manually. Create an ``AudioReport`` instance
     instead.
@@ -280,7 +280,7 @@ class Meta:
 
 class SensitiveAudio(AbstractSensitiveMedia):
     """
-    Represents audio tracks that have been flagged and verified as 'mature'.
+    Represents audio tracks with verified sensitivity reports.
 
     Do not create instances of this model manually. Create an ``AudioReport`` instance
     instead.
@@ -307,9 +307,9 @@ class Meta:
 
 class AudioReport(AbstractMediaReport):
     """
-    Represents audio tracks that have been reported by users.
+    Represents user-submitted reports of audio tracks.
 
-    This contains an ``AudioDecision`` as well, if moderators have made a decision
+    ``AudioDecision`` is populated only if moderators have made a decision
     for this report.
     """
 

api/api/models/image.py

@@ -60,7 +60,7 @@ def sensitive(self) -> bool:
 
 class DeletedImage(AbstractDeletedMedia):
     """
-    Represents images that have been deleted from the source.
+    Represents images deleted from the upstream source.
 
     Do not create instances of this model manually. Create an ``ImageReport`` instance
     instead.
@@ -83,7 +83,7 @@ class DeletedImage(AbstractDeletedMedia):
 
 class SensitiveImage(AbstractSensitiveMedia):
     """
-    Represents images that have been flagged and verified as 'mature'.
+    Represents images with verified sensitivity reports.
 
     Do not create instances of this model manually. Create an ``ImageReport`` instance
     instead.
@@ -109,7 +109,7 @@ class Meta:
 
 class ImageReport(AbstractMediaReport):
     """
-    Represents images that have been reported by users.
+    User-submitted report of an image.
 
     This contains an ``ImageDecision`` as well, if moderators have made a decision
     for this report.

api/api/models/media.py

@@ -77,7 +77,7 @@ class AbstractMedia(
     )
     removed_from_source = models.BooleanField(
         default=False,
-        help_text="Whether or not the media has been removed from the upstream source.",
+        help_text="Whether the media has been removed from the upstream source.",
     )
 
     view_count = models.IntegerField(