Added docstrings for update_visibility()

Author: x753

django/thunderstore/community/models/package_listing.py

@@ -397,6 +397,13 @@ def is_visible_to_user(self, user: Optional[UserType]) -> bool:
 
     @transaction.atomic
     def update_visibility(self):
+        """
+        Updates the package listing's visibility based on whether its package is active, its review status,
+        and the visibility of its active versions.
+
+        By default, listings are visible to everyone (for now). Rejected listings aren't publicly visible,
+        and listings with inactive packages aren't visible at all.
+        """
         self.visibility.public_detail = True
         self.visibility.public_list = True
         self.visibility.owner_detail = True

django/thunderstore/repository/models/package_version.py

@@ -431,6 +431,13 @@ def is_visible_to_user(self, user: UserType) -> bool:
 
     @transaction.atomic
     def update_visibility(self):
+        """
+        Updates the version's visibility based on whether it or its package is active and its review status.
+        This may also change the visibility of related listings, so it calls update_visibility() on them.
+
+        By default, versions are visible to everyone (for now). Rejected versions aren't publicly visible,
+        and inactive versions or versions with inactive packages aren't visible at all.
+        """
         self.visibility.public_detail = True
         self.visibility.public_list = True
         self.visibility.owner_detail = True