google-gemini / generative-ai-python

The official Python library for the Google Gemini API
https://pypi.org/project/google-generativeai/
Apache License 2.0
1.49k stars 293 forks source link

Publish Python API docs somewhere #590

Open markmcd opened 6 days ago

markmcd commented 6 days ago

Description of the feature request:

The Python API docs are just markdown/HTML files in the docs/ directory. We should publish them somewhere like readthedocs or a GitHub page so that the content is rendered in an easily navigable way.

What problem are you trying to solve with this feature?

Improving Python API doc usability.

Any other information you'd like to share?

No response

honnibal commented 4 days ago

I would very much like this, and actually I came to the issues page just now to ask for it :)

I actually find this a weak point of the Google Cloud Python SDK docs in general. It makes sense that there's one page about the underlying functionality, with an embedded widget that shows code examples for the various SDKs, e.g.: https://ai.google.dev/gemini-api/docs/quickstart?lang=python . This is a good docs page; it does what it's supposed to be doing. But pages like this aren't a replacement for an API reference of a particular SDK (e.g. Python). I need both.

vi-shruti commented 3 days ago

As a good first issue, I'd like to give it a go. Is it possible to contribute?