diff --git a/api/api/models/audio.py b/api/api/models/audio.py index 19f79c0c2b1..4f2b29862bd 100644 --- a/api/api/models/audio.py +++ b/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. """ diff --git a/api/api/models/image.py b/api/api/models/image.py index dab84e99ef0..d0d0b67ef6d 100644 --- a/api/api/models/image.py +++ b/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. diff --git a/api/api/models/media.py b/api/api/models/media.py index b9c1ae20774..6e91b0e7127 100644 --- a/api/api/models/media.py +++ b/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(