Use google doc style and resolve comments

Author: lsetiawan

odm2api/ODM2/services/readService.py

@@ -543,30 +543,25 @@ def getPeople(self, ids=None, firstname=None, lastname=None):
             return None
 
     def getAffiliations(self, ids=None, personfirst=None, personlast=None, orgcode=None):
-        """
-        Retrieve a list of ODM2 Affiliation objects.
-
-        Parameters
-        ----------
-        ids: list, default None
-            List of AffiliationIDs
-        personfirst: str, default None
-            Person First Name
-        personlast: str, default None
-            Person Last Name
-        orgcode: str, default None
-            Organization Code
-
-        Returns
-        -------
-        List of Affiliation objects
-
-        Examples
-        --------
-        >>> read.getAffiliations(ids=[39,40])
-        >>> read.getAffiliations(personfirst='Anthony',
-        ...                      personlast='Aufdenkampe')
-        >>> read.getAffiliations(orgcode='LimnoTech')
+        """Retrieve a list of Affiliation objects.
+
+        If no arguments are passed to the function, or their values are None,
+        all Affiliation objects in the database will be returned.
+
+        Args:
+            ids (:obj:`list`, optional): List of AffiliationIDs. Defaults to None.
+            personfirst (:obj:`str`, optional): Person First Name. Defaults to None.
+            personlast (:obj:`str`, optional): Person Last Name. Defaults to None.
+            orgcode (:obj:`str`, optional): Organization Code. Defaults to None.
+
+        Returns:
+            list: List of Affiliation objects
+
+        Examples:
+            >>> read.getAffiliations(ids=[39,40])
+            >>> read.getAffiliations(personfirst='John',
+            ...                      personlast='Smith')
+            >>> read.getAffiliations(orgcode='Acme')
 
         """
         q = self._session.query(Affiliations)