migrate to autogenerated docs/index.rst with post processing

Author: parthea

packages/google-cloud-bigquery-storage/docs/index.rst

@@ -2,42 +2,43 @@
 
 .. include:: multiprocessing.rst
 
-This package includes clients for multiple versions of Google BigQuery Storage.
-By default, you will get version ``bigquery_storage_v1``.
 
-
-API Reference
+Example Usage
 -------------
-.. toctree::
-    :maxdepth: 2
 
-    bigquery_storage_v1/services_
-    bigquery_storage_v1/types_
+.. literalinclude:: samples/quickstart/quickstart.py
+  :language: python
+  :dedent: 4
+  :start-after: [START bigquerystorage_quickstart]
+  :end-before: [END bigquerystorage_quickstart]
+
 
 API Reference
 -------------
 .. toctree::
     :maxdepth: 2
 
+    bigquery_storage_v1/library
+    bigquery_storage_v1/services_
+    bigquery_storage_v1/types_
+    bigquery_storage_v1beta/services_
+    bigquery_storage_v1beta/types_
+    bigquery_storage_v1beta2/library
+    bigquery_storage_v1beta2/services_
+    bigquery_storage_v1beta2/types_
     bigquery_storage_v1alpha/services_
     bigquery_storage_v1alpha/types_
 
-API Reference
--------------
-.. toctree::
-    :maxdepth: 2
 
-    bigquery_storage_v1beta/services_
-    bigquery_storage_v1beta/types_
+Migration Guide
+---------------
+
+See the guide below for instructions on migrating to the 2.x release of this library.
 
-API Reference
--------------
 .. toctree::
     :maxdepth: 2
 
-    bigquery_storage_v1beta2/services_
-    bigquery_storage_v1beta2/types_
-
+    UPGRADING
 
 Changelog
 ---------

scripts/client-post-processing/bigquery-storage-integration.yaml

@@ -430,3 +430,71 @@ replacements:
           "BigQueryWriteClient",
       )
     count: 1
+    # Given that this file is mostly handwritten, we could omit the file completely when we migrate to librarian
+    # See `preserve_regex` in https://github.com/googleapis/librarian/blob/main/doc/language-onboarding.md#generate
+    # We could also consider updating the docs/index.rst template so that the majority of handwritten changes are not required
+  - paths: [
+      packages/google-cloud-bigquery-storage/docs/index.rst,
+    ]
+    before: |
+      .. include:: README.rst\n
+      .. include:: multiprocessing.rst\n
+      This package includes clients for multiple versions of Google BigQuery Storage.
+      By default, you will get version ``bigquery_storage_v1``.\n\n
+      API Reference
+      -------------
+      .. toctree::
+          :maxdepth: 2\n
+          bigquery_storage_v1/services_
+          bigquery_storage_v1/types_\n
+      API Reference
+      -------------
+      .. toctree::
+          :maxdepth: 2\n
+          bigquery_storage_v1alpha/services_
+          bigquery_storage_v1alpha/types_\n
+      API Reference
+      -------------
+      .. toctree::
+          :maxdepth: 2\n
+          bigquery_storage_v1beta/services_
+          bigquery_storage_v1beta/types_\n
+      API Reference
+      -------------
+      .. toctree::
+          :maxdepth: 2\n
+          bigquery_storage_v1beta2/services_
+          bigquery_storage_v1beta2/types_\n\n
+      Changelog
+    after: |
+      .. include:: README.rst\n
+      .. include:: multiprocessing.rst\n\n
+      Example Usage
+      -------------\n
+      .. literalinclude:: samples/quickstart/quickstart.py
+        :language: python
+        :dedent: 4
+        :start-after: [START bigquerystorage_quickstart]
+        :end-before: [END bigquerystorage_quickstart]\n\n
+      API Reference
+      -------------
+      .. toctree::
+          :maxdepth: 2\n
+          bigquery_storage_v1/library
+          bigquery_storage_v1/services_
+          bigquery_storage_v1/types_
+          bigquery_storage_v1beta/services_
+          bigquery_storage_v1beta/types_
+          bigquery_storage_v1beta2/library
+          bigquery_storage_v1beta2/services_
+          bigquery_storage_v1beta2/types_
+          bigquery_storage_v1alpha/services_
+          bigquery_storage_v1alpha/types_\n\n
+      Migration Guide
+      ---------------\n
+      See the guide below for instructions on migrating to the 2.x release of this library.\n
+      .. toctree::
+          :maxdepth: 2\n
+          UPGRADING\n
+      Changelog
+    count: 1