updated readmes and added a .gitigore

Author: pcoet

.gitignore

@@ -0,0 +1 @@
+.vscode

README.md

@@ -1,14 +1,32 @@
 # Gemini API examples
 
-This repo contains sample code for key features of the Gemini API. The repo is
-organized by programming language.
-
-These samples are embedded in parts of the
-[documentation](https://ai.google.dev), most notably in the
-[API reference](https://ai.google.dev/api).
-
-Each file is structured as a runnable test case, ensuring that samples are
-executable and functional. Each test demonstrates a single concept, and contains
-region tags that are used to demarcate the test scaffolding from the spotlight
-code. If you are contributing, code within region tags should follow sample code
-best practices - being clear, complete and concise.
+This repository contains example code for key features of the Gemini API. The
+repo is organized by programming language.
+
+The examples are embedded in the
+[Gemini API reference](https://ai.google.dev/api) and other places in the
+developer documentation.
+
+Each file is structured as a runnable test case, ensuring that examples are
+executable and functional. Each test demonstrates a single concept and contains
+special comments called _region tags_ that demarcate the test scaffolding from
+the example code snippet. Here's a Python example:
+
+```python
+def test_text_gen_text_only_prompt(self):
+    # [START text_gen_text_only_prompt]
+    from google import genai
+
+    client = genai.Client()
+    response = client.models.generate_content(
+        model="gemini-2.0-flash", contents="Write a story about a magic backpack."
+    )
+    print(response.text)
+    # [END text_gen_text_only_prompt]
+```
+
+The API reference can then be configured to show the code between the region
+tags.
+
+If you're contributing, please make sure that the code within region tags
+follows best practices for example code: clear, complete, and concise.

python/README.md

@@ -5,8 +5,15 @@ This directory contains examples of working with the Gemini API using the
 
 ## Install dependencies
 
-    pip install absl-py google-genai Pillow
+    pip install absl-py google-genai Pillow pyink
 
 ## Run a test file
 
-    python <filename>.py
+    python <filename>.py
+
+## Format code
+
+We use [pyink](https://pypi.org/project/pyink/) for code formatting. To format
+the all the files in this directory, run:
+
+    pyink .