Merge documentation updates from PR #59

cmlccie · cmlccie · commit 255a1d39f1eb · 2018-08-30T10:26:50.000-04:00
Great catches and fixes by @UniversalSuperBox. Pull them into the webexteamssdk package.
diff --git a/docs/conf.py b/docs/conf.py
@@ -11,7 +11,7 @@
 
 
 project = u'webexteamssdk'
-copyright = u'2016 Cisco Systems, Inc.'
+copyright = u'Copyright (c) 2016-2018 Cisco and/or its affiliates.'
 author = u'Chris Lunsford'
 version = get_versions()['version']
 release = get_versions()['version']
@@ -62,7 +62,9 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {
+    'collapse_navigation': False
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
@@ -90,7 +92,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
diff --git a/docs/user/api.rst b/docs/user/api.rst
@@ -104,7 +104,7 @@ roles
 .. _events:
 
 events
------
+------
 
 .. autoclass:: webexteamssdk.api.events.EventsAPI()
 
diff --git a/docs/user/intro.rst b/docs/user/intro.rst
@@ -136,7 +136,7 @@ Head over to the :ref:`Quickstart` page to begin working with the
 **Webex Teams APIs in native Python**!
 
 
-.. _License:
+.. _MITLicense:
 
 MIT License
 -----------
diff --git a/script/build b/script/build
@@ -44,5 +44,5 @@ fi
 if [ ${all} ] || [ ${docs} ]; then
     echo "==> Building the Docs"
     make -C docs clean
-    make -C docs html
+    make -C docs html SPHINXOPTS="-W"
 fi
diff --git a/webexteamssdk/api/access_tokens.py b/webexteamssdk/api/access_tokens.py
@@ -118,7 +118,7 @@ def get(self, client_id, client_secret, code, redirect_uri):
 
         Returns:
             AccessToken: An AccessToken object with the access token provided
-                by the Webex Teams cloud.
+            by the Webex Teams cloud.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -159,7 +159,7 @@ def refresh(self, client_id, client_secret, refresh_token):
 
         Returns:
             AccessToken: With the access token provided by the Webex Teams
-                cloud.
+            cloud.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/events.py b/webexteamssdk/api/events.py
@@ -111,7 +111,7 @@ def list(self, resource=None, type=None, actorId=None, _from=None, to=None,
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the events returned by the Webex Teams query.
+            yields the events returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/licenses.py b/webexteamssdk/api/licenses.py
@@ -98,7 +98,7 @@ def list(self, orgId=None, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the licenses returned by the Webex Teams query.
+            yields the licenses returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -129,7 +129,7 @@ def get(self, licenseId):
 
         Returns:
             License: A License object with the details of the requested
-                License.
+            License.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/memberships.py b/webexteamssdk/api/memberships.py
@@ -108,7 +108,7 @@ def list(self, roomId=None, personId=None, personEmail=None, max=None,
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the memberships returned by the Webex Teams query.
+            yields the memberships returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -152,7 +152,7 @@ def create(self, roomId, personId=None, personEmail=None,
 
         Returns:
             Membership: A Membership object with the details of the created
-                membership.
+            membership.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -186,7 +186,7 @@ def get(self, membershipId):
 
         Returns:
             Membership: A Membership object with the details of the requested
-                membership.
+            membership.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -212,7 +212,7 @@ def update(self, membershipId, isModerator=None, **request_parameters):
 
         Returns:
             Membership: A Membership object with the updated Webex Teams
-                membership details.
+            membership details.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/messages.py b/webexteamssdk/api/messages.py
@@ -105,7 +105,7 @@ def list(self, roomId, mentionedPeople=None, before=None,
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the messages returned by the Webex Teams query.
+            yields the messages returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -152,7 +152,7 @@ def create(self, roomId=None, toPersonId=None, toPersonEmail=None,
                 specified this parameter may be optionally used to provide
                 alternate text for UI clients that do not support rich text.
             markdown(basestring): The message, in markdown format.
-            files(list): A list of public URL(s) or local path(s) to files to
+            files(`list`): A list of public URL(s) or local path(s) to files to
                 be posted into the room. Only one file is allowed per message.
             **request_parameters: Additional request parameters (provides
                 support for parameters that may be added in the future).
@@ -226,7 +226,7 @@ def get(self, messageId):
 
         Returns:
             Message: A Message object with the details of the requested
-                message.
+            message.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/organizations.py b/webexteamssdk/api/organizations.py
@@ -91,7 +91,7 @@ def list(self, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the organizations returned by the Webex Teams query.
+            yields the organizations returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -120,7 +120,7 @@ def get(self, orgId):
 
         Returns:
             Organization: An Organization object with the details of the
-                requested organization.
+            requested organization.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/people.py b/webexteamssdk/api/people.py
@@ -101,7 +101,7 @@ def list(self, email=None, displayName=None, id=None, orgId=None, max=None,
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the people returned by the Webex Teams query.
+            yields the people returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -138,16 +138,16 @@ def create(self, emails, displayName=None, firstName=None, lastName=None,
         Only an admin can create a new user account.
 
         Args:
-            emails(list): Email address(es) of the person (list of strings).
+            emails(`list`): Email address(es) of the person (list of strings).
             displayName(basestring): Full name of the person.
             firstName(basestring): First name of the person.
             lastName(basestring): Last name of the person.
             avatar(basestring): URL to the person's avatar in PNG format.
             orgId(basestring): ID of the organization to which this
                 person belongs.
-            roles(list): Roles of the person (list of strings containing
+            roles(`list`): Roles of the person (list of strings containing
                 the role IDs to be assigned to the person).
-            licenses(list): Licenses allocated to the person (list of
+            licenses(`list`): Licenses allocated to the person (list of
                 strings - containing the license IDs to be allocated to the
                 person).
             **request_parameters: Additional request parameters (provides
@@ -226,16 +226,16 @@ def update(self, personId, emails=None, displayName=None, firstName=None,
 
         Args:
             personId(basestring): The person ID.
-            emails(list): Email address(es) of the person (list of strings).
+            emails(`list`): Email address(es) of the person (list of strings).
             displayName(basestring): Full name of the person.
             firstName(basestring): First name of the person.
             lastName(basestring): Last name of the person.
             avatar(basestring): URL to the person's avatar in PNG format.
             orgId(basestring): ID of the organization to which this
                 person belongs.
-            roles(list): Roles of the person (list of strings containing
+            roles(`list`): Roles of the person (list of strings containing
                 the role IDs to be assigned to the person).
-            licenses(list): Licenses allocated to the person (list of
+            licenses(`list`): Licenses allocated to the person (list of
                 strings - containing the license IDs to be allocated to the
                 person).
             **request_parameters: Additional request parameters (provides
diff --git a/webexteamssdk/api/roles.py b/webexteamssdk/api/roles.py
@@ -94,7 +94,7 @@ def list(self, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the roles returned by the Webex Teams query.
+            yields the roles returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/rooms.py b/webexteamssdk/api/rooms.py
@@ -105,7 +105,7 @@ def list(self, teamId=None, type=None, sortBy=None, max=None,
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the rooms returned by the Webex Teams query.
+            yields the rooms returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/team_memberships.py b/webexteamssdk/api/team_memberships.py
@@ -95,7 +95,7 @@ def list(self, teamId, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the team memberships returned by the Webex Teams query.
+            yields the team memberships returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -136,7 +136,7 @@ def create(self, teamId, personId=None, personEmail=None,
 
         Returns:
             TeamMembership: A TeamMembership object with the details of the
-                created team membership.
+            created team membership.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -170,7 +170,7 @@ def get(self, membershipId):
 
         Returns:
             TeamMembership: A TeamMembership object with the details of the
-                requested team membership.
+            requested team membership.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -196,7 +196,7 @@ def update(self, membershipId, isModerator=None, **request_parameters):
 
         Returns:
             TeamMembership: A TeamMembership object with the updated Webex
-                Teams team-membership details.
+            Teams team-membership details.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/teams.py b/webexteamssdk/api/teams.py
@@ -94,7 +94,7 @@ def list(self, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the teams returned by the Webex Teams query.
+            yields the teams returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
diff --git a/webexteamssdk/api/webhooks.py b/webexteamssdk/api/webhooks.py
@@ -94,7 +94,7 @@ def list(self, max=None, **request_parameters):
 
         Returns:
             GeneratorContainer: A GeneratorContainer which, when iterated,
-                yields the webhooks returned by the Webex Teams query.
+            yields the webhooks returned by the Webex Teams query.
 
         Raises:
             TypeError: If the parameter types are incorrect.
@@ -169,7 +169,7 @@ def get(self, webhookId):
 
         Returns:
             Webhook: A Webhook object with the details of the requested
-                webhook.
+            webhook.
 
         Raises:
             TypeError: If the parameter types are incorrect.
