Merge pull request #1796 from weaviate/docstring_user_create

Improve user create docstring

Author: dirkkul

weaviate/users/base.py

@@ -349,10 +349,13 @@ def revoke_roles(
         )
 
     def create(self, *, user_id: str) -> executor.Result[str]:
-        """Create a new db user.
+        """Create a new db user and return its API key.
 
         Args:
             user_id: The id of the new user.
+
+        Returns:
+            The API key of the newly created user. This key can not be retrieved later.
         """
 
         def resp(res: Response) -> str: