docs: Fix documentation after internal review by dishaprakash · Pull Request #2723 · googleapis/genai-toolbox

dishaprakash · 2026-03-12T13:13:05Z

Description

This PR:

Splits PR Preview into build and deploy workflows to fix RCE Vulnerability.
Moves pre and post processing to Build with MCP toolbox
Adds headings to _index.md pages which lists the directories under it.
Adds discord link and medium logo
Reference the quickstarts from getting-started

PR Checklist

Thank you for opening a Pull Request! Before submitting your PR, there are a
few things you can do to make sure it goes smoothly:

Make sure you reviewed
CONTRIBUTING.md
Make sure to open an issue as a
bug/issue
before writing your code! That way we can discuss the change, evaluate
designs, and agree on the general idea
Ensure the tests and linter pass
Code coverage does not decrease (if any source code was changed)
Appropriate docs were updated (if necessary)
Make sure to add ! if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>

gemini-code-assist · 2026-03-12T13:13:49Z

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly refactors the documentation structure by relocating pre and post-processing guides to a more intuitive 'Build with MCP Toolbox' section. The changes aim to enhance the user experience by improving content organization and discoverability, including the addition of new navigational headings and a direct link to the community Discord server. These updates ensure that users can more easily find relevant information and engage with the MCP Toolbox community.

Highlights

Documentation Reorganization: Moved pre and post-processing documentation from the 'user-guide/configuration' path to a new 'build-with-mcp-toolbox' section to improve logical grouping and discoverability.
Navigation Enhancements: Added new headings to several _index.md files, such as 'Explore Configuration Modules' and 'Available Connection Methods', to enhance navigation and content discoverability within the documentation.
Community Integration: Introduced a new documentation page for the Discord community, providing a direct link and redirect for users to join.
Build Configuration Updates: Updated Cloud Build configuration files to reflect the new documentation paths for Go, JavaScript, and Python pre-post processing examples.

Changelog

.ci/sample_tests/pre_post_processing/go.integration.cloudbuild.yaml
- Updated the target root path for Go pre-post processing documentation.
.ci/sample_tests/pre_post_processing/js.integration.cloudbuild.yaml
- Updated the target root path for JavaScript pre-post processing documentation.
.ci/sample_tests/pre_post_processing/py.integration.cloudbuild.yaml
- Updated the target root path for Python pre-post processing documentation.
docs/en/blogs/_index.md
- Added a newspaper icon to the 'Featured Articles' page.
docs/en/discord/_index.md
- Added a new page with a Discord link and redirect.
docs/en/integrations/_index.md
- Adjusted the display weight of the Integrations section.
docs/en/reference/_index.md
- Adjusted the display weight of the Reference section.
docs/en/user-guide/_index.md
- Adjusted the display weight of the User Guide section.
docs/en/user-guide/configuration/_index.md
- Added a new heading 'Explore Configuration Modules'.
docs/en/user-guide/configuration/pre-post-processing/_index.md
- Renamed the index file for pre-post processing documentation.
docs/en/user-guide/configuration/pre-post-processing/go.md
- Renamed the Go-specific pre-post processing guide.
docs/en/user-guide/configuration/pre-post-processing/go/adk/agent.go
- Renamed the Go ADK agent example file.
docs/en/user-guide/configuration/pre-post-processing/go/adk/go.mod
- Renamed the Go module definition file.
docs/en/user-guide/configuration/pre-post-processing/go/adk/go.sum
- Renamed the Go module checksum file.
docs/en/user-guide/configuration/pre-post-processing/go/agent_test.go
- Renamed the Go agent test file.
docs/en/user-guide/configuration/pre-post-processing/js.md
- Renamed the JavaScript-specific pre-post processing guide.
docs/en/user-guide/configuration/pre-post-processing/js/adk/agent.js
- Renamed the JavaScript ADK agent example file.
docs/en/user-guide/configuration/pre-post-processing/js/adk/package-lock.json
- Renamed the JavaScript package lock file.
docs/en/user-guide/configuration/pre-post-processing/js/adk/package.json
- Renamed the JavaScript package definition file.
docs/en/user-guide/configuration/pre-post-processing/js/agent.test.js
- Renamed the JavaScript agent test file.
docs/en/user-guide/configuration/pre-post-processing/js/langchain/agent.js
- Renamed the JavaScript Langchain agent example file.
docs/en/user-guide/configuration/pre-post-processing/js/langchain/package-lock.json
- Renamed the JavaScript Langchain package lock file.
docs/en/user-guide/configuration/pre-post-processing/js/langchain/package.json
- Renamed the JavaScript Langchain package definition file.
docs/en/user-guide/configuration/pre-post-processing/python.md
- Renamed the Python-specific pre-post processing guide.
docs/en/user-guide/configuration/pre-post-processing/python/init.py
- Renamed the Python initialization file.
docs/en/user-guide/configuration/pre-post-processing/python/adk/agent.py
- Renamed the Python ADK agent example file.
docs/en/user-guide/configuration/pre-post-processing/python/adk/requirements.txt
- Renamed the Python ADK requirements file.
docs/en/user-guide/configuration/pre-post-processing/python/agent_test.py
- Renamed the Python agent test file.
docs/en/user-guide/configuration/pre-post-processing/python/langchain/agent.py
- Renamed the Python Langchain agent example file.
docs/en/user-guide/configuration/pre-post-processing/python/langchain/requirements.txt
- Renamed the Python Langchain requirements file.
docs/en/user-guide/connect-to/_index.md
- Added a new heading 'Available Connection Methods'.
docs/en/user-guide/connect-to/client-sdks/_index.md
- Refined the introductory text for client SDKs.
docs/en/user-guide/getting-started/_index.md
- Removed an extraneous blank line and introduced a 'Popular Quickstarts' section with new content.

Ignored Files

Ignored by pattern: .github/workflows/** (2)
- .github/workflows/docs_preview_build_cf.yaml
- .github/workflows/docs_preview_deploy_cf.yaml

Activity

No activity has been recorded for this pull request yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

github-actions · 2026-03-12T13:16:10Z

Link Resolution Note

Local links and directory changes work differently on GitHub than on the docsite. You must ensure fixes pass the GitHub check and also work with hugo server.
See Link Checking and Fixing with Lychee for more details.

Summary

Status	Count
🔍 Total	1037
✅ Successful	782
⏳ Timeouts	0
👻 Excluded	57
❓ Unknown	0
🚫 Errors	6
⛔ Unsupported	0

Errors per input

Errors in DEVELOPER.md

[ERROR] https://play.dgraph.io/ | Network error: Connection failed. Check network connectivity and firewall settings (error sending request for url (https://play.dgraph.io/)): Connection failed. Check network connectivity and firewall settings

Errors in docs/en/integrations/alloydb-admin/alloydb-create-cluster.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Network error: HTTP/2 protocol error. Server may not support HTTP/2 properly (error sending request for url (https://console.cloud.google.com/apis/library/alloydb.googleapis.com)): HTTP/2 protocol error. Server may not support HTTP/2 properly

Errors in docs/en/integrations/alloydb-admin/alloydb-create-instance.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Error (cached)

Errors in docs/en/integrations/alloydb-admin/alloydb-create-user.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Error (cached)

Errors in docs/en/user-guide/connect-to/client-sdks/javascript-sdk/core/index.md

[404] https://langchain-ai.github.io/langgraphjs/reference/functions/langgraph_prebuilt.createReactAgent.html | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in docs/en/user-guide/connect-to/mcp-client/_index.md

[404] https://docs.windsurf.com/windsurf/mcp | Rejected status code: 404 Not Found (configurable with "accept" option)

Full Github Actions output

github-actions · 2026-03-12T13:17:24Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2723/

gemini-code-assist

Code Review

This pull request reorganizes the documentation by moving the pre- and post-processing guides and adds links for community engagement. The changes are mostly correct, but I've found a couple of issues. The new Discord link is a direct channel link which won't work for new users, and should be replaced with a server invite link. Also, the icon for the Medium blog link could be more specific to better represent the brand. Finally, the new quickstarts section would be more helpful with direct links. I've left specific comments with suggestions for these points.

docs/en/discord/_index.md

docs/en/blogs/_index.md

docs/en/user-guide/getting-started/_index.md

github-actions · 2026-03-12T13:24:19Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2723/

github-actions · 2026-03-12T13:37:51Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2723/

github-actions · 2026-03-12T14:08:42Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2723/

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

github-actions · 2026-03-17T13:15:32Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2723/

github-actions · 2026-03-23T16:10:05Z

🧨 Preview deployments removed.

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - #2647 - #2648 - #2649 - #2650 - #2652 - #2664 - #2665 - #2666 - #2668 - #2670 - #2723 - #2779 - #2788 - #2790 ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com>

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - googleapis#2647 - googleapis#2648 - googleapis#2649 - googleapis#2650 - googleapis#2652 - googleapis#2664 - googleapis#2665 - googleapis#2666 - googleapis#2668 - googleapis#2670 - googleapis#2723 - googleapis#2779 - googleapis#2788 - googleapis#2790 ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - #2647 - #2648 - #2649 - #2650 - #2652 - #2664 - #2665 - #2666 - #2668 - #2670 - #2723 - #2779 - #2788 - #2790 ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - googleapis#2647 - googleapis#2648 - googleapis#2649 - googleapis#2650 - googleapis#2652 - googleapis#2664 - googleapis#2665 - googleapis#2666 - googleapis#2668 - googleapis#2670 - googleapis#2723 - googleapis#2779 - googleapis#2788 - googleapis#2790 ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

dishaprakash requested a review from a team as a code owner March 12, 2026 13:13

blunderbuss-gcf bot assigned Yuan325 Mar 12, 2026

gemini-code-assist bot reviewed Mar 12, 2026

View reviewed changes

docs/en/discord/_index.md Outdated Show resolved Hide resolved

docs/en/blogs/_index.md Show resolved Hide resolved

docs/en/user-guide/getting-started/_index.md Outdated Show resolved Hide resolved

dishaprakash changed the title ~~docs: Move pre and post processing to Build with mcp toolbox~~ docs: Fix documentation after internal review Mar 12, 2026

Base automatically changed from google-analytics to documentation-reorg March 12, 2026 13:56

dishaprakash assigned averikitsch and unassigned Yuan325 Mar 14, 2026

dishaprakash added the priority: p1 Important issue which blocks shipping the next release. Will be fixed prior to next release. label Mar 14, 2026

dishaprakash and others added 15 commits March 17, 2026 12:58

docs: Add User Guide section

474c9f4

rebase

855a49b

docs: Add reference and other docs

79bf3a4

Update docs/en/reference/faq.md

193a42d

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

use sticky comment

81530d5

remove prs from pull_request_target and add second hugo config

714a400

docs: Add page standardization to external source integrations

0d88a0a

add documentation and ci check

8881afc

docs: Add page standardization to external tool integrations

520be56

docs: integrate Pagefind search, Google Analytics, and feedback buttons

7aac941

docs: Move pre and post processing to Build with mcp toolbox

43d6662

Update docs_preview_deploy_cf.yaml

29a36f5

gemini review

bb423c1

update links

df3bc5d

remove header check for pre and post processing samples

0898cd1

dishaprakash force-pushed the final-changes branch from 07eb9d7 to 0898cd1 Compare March 17, 2026 13:08

dishaprakash added 2 commits March 17, 2026 18:40

Update _index.md

5d9def4

Update cockroachdb-list-schemas.md

762b735

averikitsch approved these changes Mar 20, 2026

View reviewed changes

dishaprakash merged commit bed066f into documentation-reorg Mar 23, 2026
64 of 66 checks passed

dishaprakash deleted the final-changes branch March 23, 2026 16:08

dishaprakash mentioned this pull request Mar 24, 2026

docs!: update docsite #2831

Merged

6 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: Fix documentation after internal review#2723

docs: Fix documentation after internal review#2723
dishaprakash merged 19 commits intodocumentation-reorgfrom
final-changes

dishaprakash commented Mar 12, 2026 •

edited

Loading

Uh oh!

gemini-code-assist bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 17, 2026

Uh oh!

Uh oh!

github-actions bot commented Mar 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

dishaprakash commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

PR Checklist

Uh oh!

gemini-code-assist bot commented Mar 12, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Link Resolution Note

Summary

Errors per input

Errors in DEVELOPER.md

Errors in docs/en/integrations/alloydb-admin/alloydb-create-cluster.md

Errors in docs/en/integrations/alloydb-admin/alloydb-create-instance.md

Errors in docs/en/integrations/alloydb-admin/alloydb-create-user.md

Errors in docs/en/user-guide/connect-to/client-sdks/javascript-sdk/core/index.md

Errors in docs/en/user-guide/connect-to/mcp-client/_index.md

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

github-actions bot commented Mar 17, 2026

Uh oh!

Uh oh!

github-actions bot commented Mar 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

dishaprakash commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading