API docs are very hidden / should be linked from ai.google.dev/gemini-api and main readme

[ochafik]

Description of the bug:

The only place w/ actual Python classes / methods docs seems to be in the repo under docs/api/google/generativeai.md

However, there's a prominent ai.google.dev/gemini-api/docs link which immediately takes the user away. There, one might expect API Reference to be it, but alas, no API docs either (nor from the Cookbook).

Luckily Gemini's GenerativeModel doc does seem to now rank higher than Vertex AI's on Google Search, but the latter looks more appealing and there's no warning about their differences.

(for instance, I tripped up on the lack of system_instruction param in GenerativeModel.generate_text - it's actually in the class' ctor), when the closest to an API doc I could find on ai.google.dev, the REST API for models.generateContent, listed it, similar to vertex ai's doc)

Actual vs expected behavior:

No response

Any other information you'd like to share?

No response