DOC: doc build fixes

Author: cpcloud

doc/source/timeseries.rst

@@ -678,7 +678,7 @@ strongly recommended that you switch to using the new offset aliases.
     "A\@DEC", "BA\-DEC"
     "min", "T"
     "ms", "L"
-    "us": "U"
+    "us", "U"
 
 As you can see, legacy quarterly and annual frequencies are business quarter
 and business year ends. Please also note the legacy time rule for milliseconds

pandas/core/series.py

@@ -2731,9 +2731,9 @@ def take(self, indices, axis=0, convert=True):
 
     def isin(self, values):
         """
-        Return a boolean :ref:`~pandas.Series` showing whether each element in
-        the ref:`~pandas.Series` is exactly contained in the passed sequence of
-        ``values``.
+        Return a boolean :class:`~pandas.Series` showing whether each element
+        in the :class:`~pandas.Series` is exactly contained in the passed
+        sequence of ``values``.
 
         Parameters
         ----------

pandas/io/json.py

@@ -101,34 +101,37 @@ def read_json(path_or_buf=None, orient=None, typ='frame', dtype=True,
               convert_axes=True, convert_dates=True, keep_default_dates=True,
               numpy=False, precise_float=False, date_unit=None):
     """
-    Convert JSON string to pandas object
+    Convert a JSON string to pandas object
 
     Parameters
     ----------
-    filepath_or_buffer : a VALID JSON string or file handle / StringIO. The
-        string could be a URL. Valid URL schemes include http, ftp, s3, and
+    filepath_or_buffer : a valid JSON string or file-like
+        The string could be a URL. Valid URL schemes include http, ftp, s3, and
         file. For file URLs, a host is expected. For instance, a local file
-        could be file ://localhost/path/to/table.json
-    orient :
-        Series :
-          default is 'index'
-          allowed values are: {'split','records','index'}
-          The Series index must be unique for orient 'index'.
-
-        DataFrame :
-          default is 'columns'
-          allowed values are: {'split','records','index','columns','values'}
-          The DataFrame index must be unique for orients 'index' and 'columns'.
-          The DataFrame columns must be unique for orients 'index', 'columns',
-          and 'records'.
-
-        The format of the JSON string
-          split : dict like
-            {index -> [index], columns -> [columns], data -> [values]}
-          records : list like [{column -> value}, ... , {column -> value}]
-          index : dict like {index -> {column -> value}}
-          columns : dict like {column -> {index -> value}}
-          values : just the values array
+        could be ``file://localhost/path/to/table.json``
+
+    orient
+
+        * `Series`
+
+          - default is ``'index'``
+          - allowed values are: ``{'split','records','index'}``
+          - The Series index must be unique for orient ``'index'``.
+
+        * `DataFrame`
+
+          - default is ``'columns'``
+          - allowed values are: {'split','records','index','columns','values'}
+          - The DataFrame index must be unique for orients 'index' and 'columns'.
+          - The DataFrame columns must be unique for orients 'index', 'columns', and 'records'.
+
+        * The format of the JSON string
+
+          - split : dict like ``{index -> [index], columns -> [columns], data -> [values]}``
+          - records : list like ``[{column -> value}, ... , {column -> value}]``
+          - index : dict like ``{index -> {column -> value}}``
+          - columns : dict like ``{column -> {index -> value}}``
+          - values : just the values array
 
     typ : type of object to recover (series or frame), default 'frame'
     dtype : boolean or dict, default True