misc(docs): testing some changes to hopefully get docstrings working

pyzipline/zipline.py

@@ -16,14 +16,14 @@ class ZiplineApi:
 
         :param hostname: The hostname of your Zipline instance, WITHOUT https or http.
         :type hostname: str
-        :param token: (optional) String used for authentication when making requests.
-        :type token: str
-        :param ssl: (optional) Normally set to True, but if your Zipline instance doesn't use SSL/TLS, set this to False.
-        :type ssl: bool
-        :param enforced_signing: (optional) Normally set to True, but if having SSL/TLS cert validation issues, can turn off with False.
-        :type enforced_signing: bool
-        :param logger: (optional) If your app has a logger, pass it in here.
-        :type logger: logging.Logger
+        :param token: String used for authentication when making requests.
+        :type token: str, optional
+        :param ssl: Normally set to True, but if your Zipline instance doesn't use SSL/TLS, set this to False.
+        :type ssl: bool, optional
+        :param enforced_signing: Normally set to True, but if having SSL/TLS cert validation issues, can turn off with False.
+        :type enforced_signing: bool, optional
+        :param logger: If your app has a logger, pass it in here.
+        :type logger: logging.Logger, optional
         """
         self._rest_adapter = RestAdapter(hostname=hostname, token=token, ssl=ssl, enforced_signing=enforced_signing, logger=logger)
 
@@ -32,8 +32,8 @@ class ZiplineApi:
 
         :param user_id: Integer ID of the user
         :type user_id: int
-        :return: User object
-        :rtype: User
+        :return: The :class:`pyzipline.models.User` object matching the ID
+        :rtype: :class:`pyzipline.models.User`
         """
         result = self._rest_adapter.get(endpoint=f"user/{user_id}")
         return User(**result.data)
@@ -41,8 +41,8 @@ class ZiplineApi:
     def get_self(self) -> User:
         """Get the currently authenticated user
 
-        :return: User object
-        :rtype: User
+        :return: `pyzipline.models.User`object matching the authenticated user
+        :rtype: `pyzipline.models.User`
         """
         result = self._rest_adapter.get(endpoint=f"user")
         return User(**result.data)