docs: add summary_overview template

synthtool/gcp/templates/python_library/README.rst

@@ -15,7 +15,7 @@ Python Client for {{ metadata['repo']['name_pretty'] }} API
 .. |versions| image:: https://img.shields.io/pypi/pyversions/{{ metadata['repo']['distribution_name'] }}.svg
    :target: https://pypi.org/project/{{ metadata['repo']['distribution_name'] }}/
 .. _{{ metadata['repo']['name_pretty'] }} API: {{ metadata['repo']['product_documentation'] }}
-.. _Client Library Documentation: {{ metadata['repo']['client_documentation'] }}
+.. _Client Library Documentation: {{ metadata['repo']['client_documentation'] }}/summary_overview
 .. _Product Documentation:  {{ metadata['repo']['product_documentation'] }}
 
 Quick Start

synthtool/gcp/templates/python_library/docs/summary_overview.md

@@ -0,0 +1,22 @@
+[
+This is a templated file. Adding content to this file may result in it being
+reverted. Instead, if you want to place additional content, use
+"overview_content.md" file in `docs/` directory. The Sphinx tool will
+pick up on the content and merge the content.
+]: #
+
+# {{ metadata['repo']['name'] }} API
+
+Overview of the APIs available for {{ metadata['repo']['name'] }} API.
+
+## All entries
+
+Classes, methods and properties & attributes for
+{{ metadata['repo']['name_pretty'] }} API.
+
+[classes]({{ metadata['repo']['client_documentation'] }}/summary_class.html)
+
+[methods]({{ metadata['repo']['client_documentation'] }}/summary_method.html)
+
+[properties and
+attributes]({{ metadata['repo']['client_documentation'] }}/summary_property.html)

synthtool/gcp/templates/python_mono_repo_library/README.rst

@@ -15,7 +15,7 @@ Python Client for {{ metadata['repo']['name_pretty'] }}
 .. |versions| image:: https://img.shields.io/pypi/pyversions/{{ metadata['repo']['distribution_name'] }}.svg
    :target: https://pypi.org/project/{{ metadata['repo']['distribution_name'] }}/
 .. _{{ metadata['repo']['name_pretty'] }}: {{ metadata['repo']['product_documentation'] }}
-.. _Client Library Documentation: {{ metadata['repo']['client_documentation'] }}
+.. _Client Library Documentation: {{ metadata['repo']['client_documentation'] }}/summary_overview
 .. _Product Documentation:  {{ metadata['repo']['product_documentation'] }}
 
 Quick Start

synthtool/gcp/templates/python_mono_repo_library/docs/summary_overview.md

@@ -0,0 +1,22 @@
+[
+This is a templated file. Adding content to this file may result in it being
+reverted. Instead, if you want to place additional content, use
+"overview_content.md" file in `docs/` directory. The Sphinx tool will
+pick up on the content and merge the content.
+]: #
+
+# {{ metadata['repo']['name'] }} API
+
+Overview of the APIs available for {{ metadata['repo']['name'] }} API.
+
+## All entries
+
+Classes, methods and properties & attributes for
+{{ metadata['repo']['name_pretty'] }} API.
+
+[classes]({{ metadata['repo']['client_documentation'] }}/summary_class.html)
+
+[methods]({{ metadata['repo']['client_documentation'] }}/summary_method.html)
+
+[properties and
+attributes]({{ metadata['repo']['client_documentation'] }}/summary_property.html)