Minor docs corrections

yarn_api_client/history_server.py

@@ -103,6 +103,10 @@ def job_attempts(self, job_id):
         """
         With the job attempts API, you can obtain a collection of resources
         that represent a job attempt.
+
+        :param str job_id: The job id
+        :returns: API response object with JSON data
+        :rtype: :py:class:`yarn_api_client.base.Response`
         """
         path = '/ws/v1/history/mapreduce/jobs/{jobid}/jobattempts'.format(
             jobid=job_id)

yarn_api_client/resource_manager.py

@@ -518,7 +518,8 @@ def cluster_scheduler_queue(self, yarn_queue_name):
         tries to locate the queue using breadth-first-search algorithm.
 
         :param str yarn_queue_name: case sensitive queue name
-        :return: queue Dictionary, None if not found
+        :return: queue, None if not found
+        :rtype: dict
         """
         scheduler = self.cluster_scheduler().data
         scheduler_info = scheduler['scheduler']['schedulerInfo']
@@ -555,10 +556,12 @@ def cluster_queue_partition(self, candidate_queue, cluster_node_label):
         """
         A queue can be divided into multiple partitions having different node labels.
         Given the candidate queue and parition node label, this extracts the partition
-        we are interested in
+        we are interested in.
+
         :param dict candidate_queue: queue dictionary
         :param str cluster_node_label: case sensitive node label name
-        :return: partition Dict, None if not Found.
+        :return: partition, None if not Found.
+        :rtype: dict
         """
         for partition in candidate_queue['capacities']['queueCapacitiesByPartition']:
             if partition['partitionName'] == cluster_node_label: