DOC: doc warnings

Author: Jeff Reback <[email protected]>

Closes #15647 from jreback/doc and squashes the following commits:

6afb394 [Jeff Reback] gbq install adjustment
0fd4499 [Jeff Reback] maybe
d5ec228 [Jeff Reback] DOC: fixup some doc-links
b7ea898 [Jeff Reback] DOC: some deprecation warnings removed

Author: jreback

doc/source/index.rst.template

@@ -116,7 +116,6 @@ See the package overview for more detail about what's in the library.
     whatsnew
     install
     contributing
-    faq
     overview
     10min
     tutorials

doc/source/install.rst

@@ -260,7 +260,7 @@ Optional Dependencies
   <http://www.vergenet.net/~conrad/software/xsel/>`__, or `xclip
   <https://github.com/astrand/xclip/>`__: necessary to use
   :func:`~pandas.read_clipboard`. Most package managers on Linux distributions will have ``xclip`` and/or ``xsel`` immediately available for installation.
-* For Google BigQuery I/O - see :ref:`here <io.bigquery_deps>`.
+* For Google BigQuery I/O - see `here <https://pandas-gbq.readthedocs.io/en/latest/install.html#dependencies>`__
 
 * `Backports.lzma <https://pypi.python.org/pypi/backports.lzma/>`__: Only for Python 2, for writing to and/or reading from an xz compressed DataFrame in CSV; Python 3 support is built into the standard library.
 * One of the following combinations of libraries is needed to use the

doc/source/whatsnew/v0.10.0.txt

@@ -303,11 +303,10 @@ Updated PyTables Support
    store.append('wp',wp)
 
    # selecting via A QUERY
-   store.select('wp',
-     [ Term('major_axis>20000102'), Term('minor_axis', '=', ['A','B']) ])
+   store.select('wp', "major_axis>20000102 and minor_axis=['A','B']")
 
    # removing data from tables
-   store.remove('wp', Term('major_axis>20000103'))
+   store.remove('wp', "major_axis>20000103")
    store.select('wp')
 
    # deleting a store

doc/source/whatsnew/v0.10.1.txt

@@ -58,7 +58,7 @@ perform queries on a table, by passing a list to ``data_columns``
 
    # on-disk operations
    store.append('df', df, data_columns = ['B','C','string','string2'])
-   store.select('df',[ 'B > 0', 'string == foo' ])
+   store.select('df', "B>0 and string=='foo'")
 
    # this is in-memory version of this type of selection
    df[(df.B > 0) & (df.string == 'foo')]
@@ -110,7 +110,7 @@ columns, this is equivalent to passing a
    store.select('mi')
 
    # the levels are automatically included as data columns
-   store.select('mi', Term('foo=bar'))
+   store.select('mi', "foo='bar'")
 
 Multi-table creation via ``append_to_multiple`` and selection via
 ``select_as_multiple`` can create/select from multiple tables and return a

doc/source/whatsnew/v0.17.0.txt

@@ -329,7 +329,7 @@ has been changed to make this keyword unnecessary - the change is shown below.
 Google BigQuery Enhancements
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 - Added ability to automatically create a table/dataset using the :func:`pandas.io.gbq.to_gbq` function if the destination table/dataset does not exist. (:issue:`8325`, :issue:`11121`).
-- Added ability to replace an existing table and schema when calling the :func:`pandas.io.gbq.to_gbq` function via the ``if_exists`` argument. See the :ref:`docs <io.bigquery_writer>` for more details (:issue:`8325`).
+- Added ability to replace an existing table and schema when calling the :func:`pandas.io.gbq.to_gbq` function via the ``if_exists`` argument. See the `docs <https://pandas-gbq.readthedocs.io/en/latest/writing.html>`__ for more details (:issue:`8325`).
 - ``InvalidColumnOrder`` and ``InvalidPageToken`` in the gbq module will raise ``ValueError`` instead of ``IOError``.
 - The ``generate_bq_schema()`` function is now deprecated and will be removed in a future version (:issue:`11121`)
 - The gbq module will now support Python 3 (:issue:`11094`).

doc/source/whatsnew/v0.18.0.txt

@@ -518,7 +518,7 @@ Other enhancements
 - Added ``DataFrame.style.format`` for more flexible formatting of cell values (:issue:`11692`)
 - ``DataFrame.select_dtypes`` now allows the ``np.float16`` typecode (:issue:`11990`)
 - ``pivot_table()`` now accepts most iterables for the ``values`` parameter (:issue:`12017`)
-- Added Google ``BigQuery`` service account authentication support, which enables authentication on remote servers. (:issue:`11881`, :issue:`12572`). For further details see :ref:`here <io.bigquery_authentication>`
+- Added Google ``BigQuery`` service account authentication support, which enables authentication on remote servers. (:issue:`11881`, :issue:`12572`). For further details see `here <https://pandas-gbq.readthedocs.io/en/latest/intro.html>`__
 - ``HDFStore`` is now iterable: ``for k in store`` is equivalent to ``for k in store.keys()`` (:issue:`12221`).
 - Add missing methods/fields to ``.dt`` for ``Period`` (:issue:`8848`)
 - The entire codebase has been ``PEP``-ified (:issue:`12096`)

doc/source/whatsnew/v0.19.0.txt

@@ -377,7 +377,7 @@ For ``MultiIndex``, values are dropped if any level is missing by default. Speci
 Google BigQuery Enhancements
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- The :func:`read_gbq` method has gained the ``dialect`` argument to allow users to specify whether to use BigQuery's legacy SQL or BigQuery's standard SQL. See the :ref:`docs <io.bigquery_reader>` for more details (:issue:`13615`).
+- The :func:`read_gbq` method has gained the ``dialect`` argument to allow users to specify whether to use BigQuery's legacy SQL or BigQuery's standard SQL. See the `docs <https://pandas-gbq.readthedocs.io/en/latest/reading.html>`__ for more details (:issue:`13615`).
 - The :func:`~DataFrame.to_gbq` method now allows the DataFrame column order to differ from the destination table schema (:issue:`11359`).
 
 .. _whatsnew_0190.errstate:

doc/source/whatsnew/v0.20.0.txt

@@ -203,7 +203,7 @@ New Behavior:
 
   df[df.chromosomes != '1'].groupby('chromosomes', sort=False).sum()
 
-.. _whatsnew_0200.enhancements.table_schema
+.. _whatsnew_0200.enhancements.table_schema:
 
 Table Schema Output
 ^^^^^^^^^^^^^^^^^^^
@@ -337,7 +337,7 @@ Using ``.iloc``. Here we will get the location of the 'A' column, then use *posi
   df.iloc[[0, 2], df.columns.get_loc('A')]
 
 
-.. _whatsnew.api_breaking.io_compat
+.. _whatsnew.api_breaking.io_compat:
 
 Possible incompat for HDF5 formats for pandas < 0.13.0
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -758,7 +758,7 @@ Bug Fixes
 
 - Bug in the display of ``.info()`` where a qualifier (+) would always be displayed with a ``MultiIndex`` that contains only non-strings (:issue:`15245`)
 
-- Bug in ``.asfreq()``, where frequency was not set for empty ``Series` (:issue:`14320`)
+- Bug in ``.asfreq()``, where frequency was not set for empty ``Series`` (:issue:`14320`)
 
 - Bug in ``pd.read_msgpack()`` in which ``Series`` categoricals were being improperly processed (:issue:`14901`)
 - Bug in ``Series.ffill()`` with mixed dtypes containing tz-aware datetimes. (:issue:`14956`)

pandas/io/gbq.py

@@ -14,8 +14,9 @@ def _try_import():
                           "the pandas-gbq package is not installed\n"
                           "see the docs: https://pandas-gbq.readthedocs.io\n"
                           "\n"
-                          "you can install via:\n"
-                          "pip install pandas-gbq\n")
+                          "you can install via pip or conda:\n"
+                          "pip install pandas-gbq\n"
+                          "conda install pandas-gbq -c conda-forge\n")
 
     return pandas_gbq