Follow comments & polish doc

python/paddle/fluid/recordio_writer.py

@@ -103,6 +103,10 @@ def convert_reader_to_recordio_files(
     This API is basically same as :code:`convert_reader_to_recordio_file`,
     instead of it will create many recordio files. Each file contains at
     most :code:`batch_per_file` records.
+
+    Please reference
+    :ref:`api_fluid_recordio_writer_convert_reader_to_recordio_file` for more
+    details.
     """
     if feed_order is None:
         feed_order = feeder.feed_names

python/paddle/fluid/trainer.py

@@ -389,11 +389,11 @@ class Trainer(object):
         Start the train loop to train the model.
 
         Args:
-            num_epochs: The number of epoch. An epoch will process all data in reader
-            event_handler: The event handler. A function with type (ev:Event)->void
-            reader: A reader creator object. See also
+            num_epochs(int): The number of epoch. An epoch will process all data in reader
+            event_handler(callable): The event handler. A function with type (ev:Event)->void
+            reader(callable): A reader creator object. See also
                 :ref:`api_guide_python_reader` .
-            feed_order: Feeding order of reader. None will following the defining
+            feed_order(list): Feeding order of reader. None will following the defining
                 order in program
 
         Returns:
@@ -427,9 +427,10 @@ class Trainer(object):
 
     def save_params(self, param_path):
         """
-        Save all parameters into :code:`param_path`
+        Save all parameters into :code:`param_path`.
+
         Args:
-            param_path(str): The path to save parameters
+            param_path(str): The path to save parameters.
 
         Returns:
             None