integrate autodoc return values

mastodon/admin.py

@@ -19,7 +19,7 @@ class Mastodon(Internals):
     def admin_accounts_v2(self, origin: Optional[str] = None, by_domain: Optional[str] = None, status: Optional[str] = None, username: Optional[str] = None, 
                           display_name: Optional[str] = None, email: Optional[str] = None, ip: Optional[str] = None, permissions: Optional[str] = None, 
                           invited_by: Union[Account, IdType] = None, role_ids: Optional[List[IdType]] = None, max_id: Optional[IdType] = None, min_id: Optional[IdType] = None, 
-                          since_id: Optional[IdType] = None, limit: Optional[int] = None) -> AdminAccount:
+                          since_id: Optional[IdType] = None, limit: Optional[int] = None) -> List[AdminAccount]:
         """
         Fetches a list of accounts that match given criteria. By default, local accounts are returned.
 

mastodon/return_types.py

@@ -2655,7 +2655,7 @@ class InstanceV2(AttribAccessDict):
 
     icon: "EntityList[InstanceIcon]"
     """
-    The instance icon, as a list of `InstanceIcon`s, with entries representing different available size variants.
+    The instance icon, as a list of `InstanceIcon` , with entries representing different available size variants.
     Should contain (as text): URL
 
     Version history:

mastodon/types_base.py

@@ -362,8 +362,9 @@ class NonPaginatableList(List[T]):
     """
     pass
 
-"""Lists in Mastodon.py are either regular or paginatable"""
 EntityList = Union[NonPaginatableList[T], PaginatableList[T]]
+"""Lists in Mastodon.py are either regular or paginatable, so this is a union of
+   :class:`NonPaginatableList` and :class:`PaginatableList`."""
 
 try:
     OrderedStrDict = OrderedDict[str, Any]
@@ -510,14 +511,15 @@ class AttribAccessDict(OrderedStrDict):
                 pass
         return False
     
-"""An entity returned by the Mastodon API is either a dict or a list"""
+
 Entity = Union[AttribAccessDict, EntityList]
+"""Base class for everything returned by the API. This is a union of :class:`AttribAccessDict` and :class:`EntityList`."""
 
-"""A type containing the parameters for a encrypting webpush data. Considered opaque / implementation detail."""
 WebpushCryptoParamsPubkey = Dict[str, str]
+"""A type containing the parameters for a encrypting webpush data. Considered opaque / implementation detail."""
 
-"""A type containing the parameters for a derypting webpush data. Considered opaque / implementation detail."""
 WebpushCryptoParamsPrivkey = Dict[str, str]
+"""A type containing the parameters for a derypting webpush data. Considered opaque / implementation detail."""
 
-"""Backwards compatibility alias"""
 AttribAccessList = PaginatableList
+"""Backwards compatibility alias"""