Merge doc strings

Author: schloerke

src/posit/connect/permissions.py

@@ -67,25 +67,12 @@ def count(self) -> int:
         return len(self.find())
 
     @overload
-    def create(self, *, principal_guid: str, principal_type: str, role: str) -> Permission:
-        """Create a permission.
-
-        Parameters
-        ----------
-        principal_guid : str
-            User guid or Group guid.
-        principal_type : str
-            The principal type. Either `"user"` or `"group"`.
-        role : str
-            The principal role. Currently only `"viewer"` and `"owner"` are supported
-
-        Returns
-        -------
-        Permission
-        """
+    def create(self, *, principal_guid: str, principal_type: str, role: str) -> Permission: ...
 
     @overload
-    def create(self, *args: User | Group, role: str) -> list[Permission]:
+    def create(self, *args: User | Group, role: str) -> list[Permission]: ...
+
+    def create(self, *args: User | Group, **kwargs) -> Permission | list[Permission]:
         """Create a permission.
 
         Parameters
@@ -94,10 +81,18 @@ def create(self, *args: User | Group, role: str) -> list[Permission]:
             The principal users or groups to add.
         role : str
             The principal role. Currently only `"viewer"` and `"owner"` are supported.
+        principal_guid : str
+            User guid or Group guid.
+        principal_type : str
+            The principal type. Either `"user"` or `"group"`.
+        role : str
+            The principal role. Currently only `"viewer"` and `"owner"` are supported
 
         Returns
         -------
-        Permission
+        Permission | List[Permission]
+            Returns a `Permission` when the kwargs: `principal_guid`, `principal_type`, and `role`
+            are used. Returns a `list[Permission]` when `*args` are used.
 
         Examples
         --------
@@ -141,8 +136,6 @@ def create(self, *args: User | Group, role: str) -> list[Permission]:
         content_item.permissions.find()
         ```
         """
-
-    def create(self, *args: User | Group, **kwargs) -> Permission | list[Permission]:
         if len(args) > 0:
             # Avoid circular imports
             from .groups import Group
@@ -232,7 +225,7 @@ def destroy(self, *permissions: str | Group | User | Permission) -> list[Permiss
         Returns
         -------
         list[Permission]
-            The removed permissions. If a permission is not found, there is nothing to remove and 
+            The removed permissions. If a permission is not found, there is nothing to remove and
             it is not included in the returned list.
 
         Examples