Update import advice in template (#691)

* Updated template notebook with newer guidance
* Minimum version

---------

Co-authored-by: Guillaume Vernade <[email protected]>

Author: markmcd

quickstarts/Template.ipynb

@@ -75,13 +75,26 @@
       },
       "outputs": [],
       "source": [
-        "%pip install -U -q \"google-genai>=1.0.0\" # Install the Python SDK\n",
+        "%pip install -U -q \"google-genai>=1.0.0\"  # Install the Python SDK\n",
         "\n",
         "# Always set at least 1.0.0 as the minimal version as there were breaking\n",
         "# changes through the previous versions\n",
         "# Of course, if your notebook uses a new feature and needs a more recent\n",
         "# version, set the right minimum version to indicate when the feature was\n",
-        "# introduced"
+        "# introduced.\n",
+        "# Always test your notebook with that fixed version (eg. '==1.0.0') to make.\n",
+        "# sure it's really the minimum version.\n",
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 7,
+      "metadata": {
+        "id": "iQSKjF5WH5N9"
+      },
+      "outputs": [],
+      "source": [
+        "from google import genai"
       ]
     },
     {
@@ -141,12 +154,7 @@
       "source": [
         "## [Write your guide]\n",
         "\n",
-        "1.   Élément de liste\n",
-        "2.   Élément de liste\n",
-        "\n",
-        "\n",
-        "\n",
-        "[Add as many high level sections as needed to step through your guide. Try to introduce new concepts incrementally, and remember that notebooks need to be executable from start to finish using `Runtime -> Run all` in Colab.]"
+        "[Add as many high level sections as needed to step through your guide. Try to introduce new concepts incrementally, including explanatory text at every step. Remember that notebooks need to be executable from start to finish using `Runtime -> Run all` in Colab.]"
       ]
     },
     {
@@ -195,11 +203,12 @@
         "* Use one `H1` header for the title.\n",
         "* Include the button-bar immediately after the `H1`.\n",
         "* Include an overview section before any code.\n",
-        "* Put all your installs and imports in a setup section.\n",
+        "* Keep your installs and imports close to the code that first uses them. If they are used throughout (such as the SDK), they can go at the start of the guide.\n",
         "* Keep code and text cells as brief as possible.\n",
         "* Break text cells at headings\n",
         "* Break code cells between \"building\" and \"running\", and between \"printing one result\" and \"printing another result\".\n",
-        "* Necessary but uninteresting code should be hidden in a toggleable code cell by putting `# @title` as the first line."
+        "* Necessary but uninteresting code should be hidden in a toggleable code cell by putting `# @title` as the first line.\n",
+        "* You can optionally add a byline for content in `examples/` that you wrote, including one link to your GitHub, social, or site of your choice."
       ]
     },
     {
@@ -224,7 +233,7 @@
         "* Demonstrate small parts before combining them into something more complex.\n",
         "* Keep the code as simple as possible, only use extra parameters like temperature when needed, and in that case, explain why\n",
         "* To ensure notebook text remains accurate, present model metadata by executing code.\n",
-        "  * For example, instead of saying \"1M token context\" in the text, display the output of `genai.get_model('models/...').input_token_limit`.\n"
+        "  * For example, instead of saying \"1M token context\" in the text, display the output of `client.models.get(model='...').input_token_limit`.\n"
       ]
     },
     {