docs: Move readme content to new User Guide section

Author: TrevorBergeron

README.rst

@@ -1,8 +1,7 @@
-:orphan:
-
 BigQuery DataFrames (BigFrames)
 ===============================
 
+
 |GA| |pypi| |versions|
 
 BigQuery DataFrames (also known as BigFrames) provides a Pythonic DataFrame

docs/conf.py

@@ -118,6 +118,7 @@
     "samples/AUTHORING_GUIDE.md",
     "samples/CONTRIBUTING.md",
     "samples/snippets/README.rst",
+    "README.rst",  # used for include in overview.rst only
 ]
 
 # The reST default role (used for this markup: `text`) to use for all
@@ -163,16 +164,6 @@
     "logo": {
         "text": "BigQuery DataFrames (BigFrames)",
     },
-    "external_links": [
-        {
-            "name": "Getting started",
-            "url": "https://docs.cloud.google.com/bigquery/docs/dataframes-quickstart",
-        },
-        {
-            "name": "User guide",
-            "url": "https://docs.cloud.google.com/bigquery/docs/bigquery-dataframes-introduction",
-        },
-    ],
     "analytics": {
         "google_analytics_id": "G-XVSRMCJ37X",
     },

docs/index.rst

@@ -1,4 +1,29 @@
-.. include:: README.rst
+.. BigQuery DataFrames documentation main file
+
+Welcome to BigQuery DataFrames
+==============================
+
+**BigQuery DataFrames** (``bigframes``) provides a Pythonic interface for data analysis that scales to petabytes. It gives you the best of both worlds: the familiar API of **pandas** and **scikit-learn**, powered by the distributed computing engine of **BigQuery**.
+
+
+Why BigQuery DataFrames?
+------------------------
+
+BigFrames allows you to process data where it lives. Instead of downloading massive datasets to your local machine, BigFrames translates your Python code into SQL and executes it across the BigQuery fleet.
+
+* **Scalability:** Work with datasets that exceed local memory limits.
+* **Efficiency:** Minimize data movement and leverage BigQuery's query optimizer.
+* **Familiarity:** Use ``read_gbq``, ``merge``, ``groupby``, and ``pivot_table`` just like you do in pandas.
+* **Integrated ML:** Access BigQuery ML (BQML) capabilities through a familiar estimator-based interface.
+
+
+User Guide
+----------
+
+.. toctree::
+    :maxdepth: 2
+
+    user_guide/index
 
 API reference
 -------------

docs/user_guide/index.rst

@@ -0,0 +1,11 @@
+User Guide
+**********
+
+.. include:: ../README.rst
+
+.. toctree::
+   :caption: Guides
+   :maxdepth: 1
+
+   Getting Started <https://docs.cloud.google.com/bigquery/docs/dataframes-quickstart>
+   Cloud Docs User Guides <https://docs.cloud.google.com/bigquery/docs/bigquery-dataframes-introduction>