package analysis // golang.org/x/tools/go/analysis type Pass struct { ... // AllObjectFacts returns a new slice containing all object // facts of the analysis's FactTypes in unspecified order. AllObjectFacts func() []ObjectFact . (if unsure, please run git pull --rebase upstream main).

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -5,7 +5,7 @@ body:
   - type: markdown
     attributes:
       value: >
-        **Note:** If this is a support question (e.g. _How do I do XYZ?_), please post on the [Google Developers Community](https://discord.gg/google-dev-community) Discord server's #palm-api channel instead. This is a great place to interact with developers, and to learn, share, and support each other.
+        **Note:** If this is a support question (e.g. _How do I do XYZ?_), please visit the [Discourse forum](https://discuss.ai.google.dev/). This is a great place to interact with developers, and to learn, share, and support each other.
   - type: textarea
     id: description
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -5,7 +5,7 @@ body:
   - type: markdown
     attributes:
       value: >
-        **Note:** If this is a support question (e.g. _How do I do XYZ?_), please post on the [Google Developers Community](https://discord.gg/google-dev-community) Discord server's #palm-api channel instead. This is a great place to interact with developers, and to learn, share, and support each other.
+        **Note:** If this is a support question (e.g. _How do I do XYZ?_), please visit the [Discourse forum](https://discuss.ai.google.dev/). This is a great place to interact with developers, and to learn, share, and support each other.
   - type: textarea
     id: description
     attributes:

.github/labeler.yml

@@ -1,23 +1,32 @@
 'status:awaiting review':
 - '**/*'
 
-'demos:doc-agent':
+'component:demos':
+- demos/**/*
+
+'component:documentation':
+- site/**/*
+
+'demos:docs-agent':
 - demos/palm/python/docs-agent/**/*
 
-'examples:list-it':
+'demos:list-it':
 - demos/palm/web/list-it/**/*
 
-'examples:mood-food':
+'demos:mood-food':
 - demos/palm/web/mood-food/**/*
 
-'examples:quick-prompt':
+'demos:pipet':
+- demos/palm/node/pipet-code-agent/**/*
+
+'demos:quick-prompt':
 - demos/palm/web/quick-prompt/**/*
 
-'examples:talking-character':
+'demos:talking-character':
 - demos/palm/web/talking-character/**/*
 
-'examples:text-fx':
+'demos:text-fx':
 - demos/palm/web/textfx/**/*
 
-'examples:travel-planner':
+'demos:travel-planner':
 - demos/palm/web/travel-planner/**/*

.github/workflows/notebooks.yml

@@ -6,11 +6,12 @@ on:
   # Relevant PRs
   pull_request:
     paths:
-    - "site/en/**"
+    - "**.ipynb"
   # Allow manual runs
   workflow_dispatch:
 
 jobs:
+  # Format all notebooks.
   nbfmt:
     name: Notebook format
     runs-on: ubuntu-latest
@@ -28,7 +29,7 @@ jobs:
           readarray -t changed_notebooks < <(git diff --name-only main | grep '\.ipynb$' || true)
         else
           # Manual run, check everything
-          readarray -t changed_notebooks < <(find site/en/ -name '*.ipynb')
+          readarray -t changed_notebooks < <(find -name '*.ipynb')
         fi
         if [[ ${#changed_notebooks[@]} == 0 ]]; then
           echo "No notebooks modified in this pull request."
@@ -44,28 +45,93 @@ jobs:
     steps:
     - uses: actions/checkout@v3
     - uses: actions/setup-python@v4
+    - uses: dorny/paths-filter@v2
+      id: filter
+      with:
+        filters: |
+          website:
+            - 'site/en/**/**.ipynb'
+          github_docs:
+            - 'examples/**/**.ipynb'
+            - 'demos/**/**.ipynb'
+          templates:
+            - 'templates/**/**.ipynb'
     - name: Install tensorflow-docs
       run: python3 -m pip install -U git+https://github.com/tensorflow/docs
     - name: Fetch main branch
       run: git fetch -u origin main:main
-    - name: Lint notebooks
+
+    # Full lint for website notebooks (incl. website button)
+    - name: Lint website notebooks
+      if: steps.filter.outputs.website == 'true'
       run: |
         if [ "${{ github.event_name }}" == "pull_request" ]; then
           # Only check notebooks modified in this pull request
-          readarray -t changed_notebooks < <(git diff --name-only main | grep '\.ipynb$' || true)
+          readarray -t changed_notebooks < <(git diff --name-only main site/en/ |grep '\.ipynb$' || true)
         else
           # Manual run, check everything
           readarray -t changed_notebooks < <(find site/en/ -name '*.ipynb')
         fi
         if [[ ${#changed_notebooks[@]} == 0 ]]; then
-          echo "No notebooks modified in this pull request."
+          echo "No website notebooks modified in this pull request."
           exit 0
         else
           echo "Lint check with nblint:"
           python3 -m tensorflow_docs.tools.nblint \
             --styles=google,tensorflow \
             --arg=repo:google/generative-ai-docs --arg=branch:main \
-            --arg=base_url:https://developers.generativeai.google/ \
+            --arg=base_url:https://ai.google.dev/ \
             --exclude_lint=tensorflow::button_download \
             "${changed_notebooks[@]}"
         fi
+
+    # Reduced lint for notebooks hosted in GitHub
+    - name: Lint documentation notebooks
+      if: steps.filter.outputs.github_docs == 'true'
+      run: |
+        if [ "${{ github.event_name }}" == "pull_request" ]; then
+          # Only check notebooks modified in this pull request
+          readarray -t changed_notebooks < <(git diff --name-only main demos/ examples/ |grep '\.ipynb$' || true)
+        else
+          # Manual run, check everything
+          readarray -t changed_notebooks < <(find demos/ examples/ -name '*.ipynb')
+        fi
+        if [[ ${#changed_notebooks[@]} == 0 ]]; then
+          echo "No GitHub doc notebooks modified in this pull request."
+          exit 0
+        else
+          echo "Lint check with nblint:"
+          python3 -m tensorflow_docs.tools.nblint \
+            --styles=google,tensorflow \
+            --arg=repo:google/generative-ai-docs --arg=branch:main \
+            --exclude_lint=tensorflow::button_download \
+            --exclude_lint=tensorflow::button_website \
+            "${changed_notebooks[@]}"
+        fi
+
+    # Basic lint for template notebooks
+    - name: Lint template notebooks
+      if: steps.filter.outputs.templates == 'true'
+      run: |
+        if [ "${{ github.event_name }}" == "pull_request" ]; then
+          # Only check notebooks modified in this pull request
+          readarray -t changed_notebooks < <(git diff --name-only main templates/ |grep '\.ipynb$' || true)
+        else
+          # Manual run, check everything
+          readarray -t changed_notebooks < <(find templates/ -name '*.ipynb')
+        fi
+        if [[ ${#changed_notebooks[@]} == 0 ]]; then
+          echo "No template notebooks modified in this pull request."
+          exit 0
+        else
+          echo "Lint check with nblint:"
+          python3 -m tensorflow_docs.tools.nblint \
+            --styles=google,tensorflow \
+            --arg=repo:google/generative-ai-docs --arg=branch:main \
+            --exclude_lint=tensorflow::button_download \
+            --exclude_lint=tensorflow::button_website \
+            --exclude_lint=tensorflow::button_colab \
+            --exclude_lint=tensorflow::button_github \
+            "${changed_notebooks[@]}"
+        fi
+

.github/workflows/stale.yml

@@ -24,8 +24,8 @@ jobs:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         days-before-issue-stale: 14
         days-before-issue-close: 14
-        stale-issue-label: "stale"
-        close-issue-reason: completed
+        stale-issue-label: "status:stale"
+        close-issue-reason: not_planned
         any-of-labels: "status:awaiting user response,status:more data needed"
         stale-issue-message: >
           Marking this issue as stale since it has been open for 14 days with no activity.
@@ -35,7 +35,7 @@ jobs:
           Please post a new issue if you need further assistance. Thanks!
         days-before-pr-stale: 14
         days-before-pr-close: 14
-        stale-pr-label: "stale"
+        stale-pr-label: "status:stale"
         stale-pr-message: >
           Marking this pull request as stale since it has been open for 14 days with no activity.
           This PR will be closed if no further activity occurs.

.gitignore

@@ -3,7 +3,7 @@
 **/.DS_Store
 **/.idea
 **/.ipynb_checkpoints
-**/.vscode
 **/proofreading
 **/venv
 **/.python-version
+**/node_modules

CODEOWNERS

@@ -1,11 +1,14 @@
 * @google/generative-ai-admin
 
-demos/palm/web/talking-character @lyleaf @jayjicheng @blownhither
-demos/palm/web/mood-food @lyleaf @jayjicheng
-demos/palm/web/travel-planner @lyleaf @jayjicheng
-demos/palm/web/list-it @mrayinteractive @aaron-wade
-demos/palm/web/quick-prompt @mrayinteractive @aaron-wade
-demos/palm/web/textfx @mrayinteractive @aaron-wade
-demos/palm/python/docs-agent @nickvander @rundong08 @Meggin @kyolee415
+# demos/palm/web/talking-character
+# demos/palm/web/mood-food
+# demos/palm/web/travel-planner
+# demos/palm/web/list-it
+# demos/palm/web/quick-prompt
+# demos/palm/web/textfx
+examples/gemini/python/docs-agent @nickvander @rundong08 @Meggin @kyolee415
+examples/gemini/node/flutter_theme_agent/ @khanhnwin @joefernandez
+demos/palm/node/pipet-code-agent @joefernandez @shilpakancharla @markmcd
 
+templates/ @google/ai-studio-team
 site/ @google/generative-ai-site-team

DEMO_MAINTAINERS.md

@@ -0,0 +1,33 @@
+# Demo Maintenance
+
+We have several [demo applications](https://github.com/google/generative-ai-docs/tree/main/demos/palm) hosted in this repository that are referenced in the [AI for Developers](https://ai.google.dev/develop/sample-apps) site. We're looking to the community to help maintain them. 
+Thank you in advance for your contributions!
+
+## Responsibilities
+
+While we would love to accept any meaningful contributions to the demos, some tasks we'd particularly like help with include:
+1. Create a process to verify that the app works as desired after any changes are made (preferably automated, but a manual testing process works well to start)
+2. Get dependencies up-to-date
+3. Review and fix any outstanding issues and PRs (you can filter by the `demos:XYZ` [label](https://github.com/google/generative-ai-docs/labels?q=demos%3A))
+4. Migrate from PaLM to Gemini
+
+## Next Steps
+
+If you're interested and commited to maintaining one of the demos, please complete the following:
+- Read through the [Contributing Guide](https://github.com/google/generative-ai-docs/blob/main/CONTRIBUTING.md).
+- Start work on the responsibilities above.
+- Once you have some progress demonstrated, submit a PR to add your GitHub handle next to the demo you're interested in maintaining, in the section below.
+- Non-responsive maintainers will be removed without notice.
+
+## Active Maintainers
+
+| Demo  | Maintainers |
+| ------------- | ------------- |
+| [list-it](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/list-it)  | @bupd |
+| [mood-food](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/mood-food)  |   |
+| [quick-prompt](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/quick-prompt)  |   |
+| [talking-character](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/talking-character)  |   |
+| [textfx](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/textfx)  |   |
+| [travel-planner](https://github.com/google/generative-ai-docs/tree/main/demos/palm/web/travel-planner)  |  |
+| [docs-agent](https://github.com/google/generative-ai-docs/tree/main/demos/palm/python/docs-agent)  | @nickvander @rundong08 @Meggin @kyolee415  |
+| [pipet-code-agent](https://github.com/google/generative-ai-docs/tree/main/demos/palm/node/pipet-code-agent)  | @joefernandez @shilpakancharla @markmcd  |

README.md

@@ -1,11 +1,23 @@
-# Google Generative AI Documentation
+# Google Gemini API Website & Documentation
 
 These are the source files for the guide and tutorials on
-the [Generative AI developer site](https://developers.generativeai.google/).
+the [Generative AI developer site](https://ai.google.dev/), home to
+the Gemini API and Gemma.
+
+| Path | Description |
+| ---- | ----------- |
+| [`site/`](site/) | Notebooks and other content used directly on ai.google.dev. |
+| [`demos/`](demos/) | Demos apps. Larger than examples, typically consists of working apps. |
+| [`examples/`](examples/) | Examples. Smaller, single-purpose code for demonstrating specific concepts. |
+
+
 
 To contribute to the site documentation, please read
 [CONTRIBUTING.md](CONTRIBUTING.md).
 
+To contribute as a demo app maintainer, please read
+[DEMO_MAINTAINERS.md](DEMO_MAINTAINERS.md).
+
 To file an issue, please use the
 [GitHub issue tracker](https://github.com/google/generative-ai-docs/issues/new).
 

demos/palm/README.md

@@ -6,3 +6,12 @@ Demos are considered to be larger than examples and consist of working apps.
 
 Smaller, specific examples can be found in the
 [`examples/`](../../examples/palm) directory.
+
+## Updates
+
+Some of these code projects have been updated and moved to the /examples/gemini directory, including:
+
+-   **Docs Agent** - /demos/palm/python/docs-agent/ moved to: 
+    [/examples/gemini/python/docs-agent/](https://github.com/google/generative-ai-docs/tree/main/examples/gemini/python/docs-agent)
+-  **Pipet Code Agent** - /demos/palm/node/pipet-code-agent/ moved to: 
+    [/examples/gemini/node/pipet-code-agent/](https://github.com/google/generative-ai-docs/tree/main/examples/gemini/node/pipet-code-agent)