docs: Update root folder names by dishaprakash · Pull Request #2779 · googleapis/mcp-toolbox

dishaprakash · 2026-03-18T18:44:34Z

Description

Update the root folder name:

User-guide to documentation
Build-with-mcp-toolbox to Samples-hub

NOTE: This PR only makes structural changes, the UI will not be accurate to the end product. Please see PR #2790 for complete UI changes

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-18T18:47:15Z

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 focuses on improving the organization and accessibility of the project's documentation. It involves renaming and relocating several directories to better reflect their content, updating SDK documentation to align with these changes, and adding new guides for connecting IDEs to MCP. The goal is to provide a clearer and more user-friendly documentation experience.

Highlights

Documentation Restructuring: The pull request reorganizes the documentation layout by renaming the 'user-guide' folder to 'documentation' and the 'build-with-mcp-toolbox' folder to 'samples-hub', aiming for a more intuitive structure.
SDK Documentation Updates: The documentation for the Python, JavaScript/TypeScript, and Go SDKs has been updated, including changes to quickstart guides and references to the new 'samples-hub' location.
IDE Connection Guides: Several new documentation files were added to guide users on connecting various IDEs to MCP, enhancing the developer experience.

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.

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-18T18:50:28Z

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	1054
✅ Successful	797
⏳ 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/documentation/connect-to/mcp-client/_index.md

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

Errors in docs/en/documentation/connect-to/toolbox-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/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 | 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

Full Github Actions output

gemini-code-assist

Code Review

The documentation for the MCP Toolbox Go SDK was updated to include a note about providing an external custom http.Client during initialization, and a note about the native Toolbox protocol being deprecated with a suggestion to migrate to core.MCP or specific MCP versions. A link to the relevant documentation for http.Client and a migration guide for the Toolbox protocol were suggested.

I am having trouble creating individual review comments. Click here to see my feedback.

docs/en/documentation/connect-to/toolbox-sdks/go-sdk/core/_index.md (82-85)

It's good to provide a note about the http.Client, but it would be helpful to add a link to the relevant documentation for http.Client for users who are not familiar with it.

docs/en/documentation/connect-to/toolbox-sdks/go-sdk/core/_index.md (104-106)

This note mentions that the native Toolbox protocol is deprecated and will be removed on March 4, 2026. It would be helpful to provide a link to a migration guide or documentation explaining how to migrate to core.MCP or specific MCP versions.

github-actions · 2026-03-19T12:49:04Z

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

github-actions · 2026-03-19T13:34:58Z

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

github-actions · 2026-03-19T17:24:14Z

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

docs/en/documentation/getting-started/_index.md

github-actions · 2026-03-21T13:39:31Z

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

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.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 - #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

gemini-code-assist bot reviewed Mar 18, 2026

View reviewed changes

dishaprakash assigned averikitsch Mar 19, 2026

dishaprakash marked this pull request as ready for review March 19, 2026 20:43

dishaprakash requested a review from a team as a code owner March 19, 2026 20:43

averikitsch reviewed Mar 20, 2026

View reviewed changes

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

averikitsch approved these changes Mar 20, 2026

View reviewed changes

Base automatically changed from final-changes to documentation-reorg March 23, 2026 16:08

dishaprakash and others added 17 commits March 23, 2026 16:19

docs: Add User Guide section

f3fb450

rebase

2f3e42c

docs: Add reference and other docs

0224a70

Update docs/en/reference/faq.md

fecf25a

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

use sticky comment

85e1ffe

remove prs from pull_request_target and add second hugo config

fcbaef1

docs: Add page standardization to external source integrations

10f4bdd

add documentation and ci check

bb93095

docs: Add page standardization to external tool integrations

d754ee5

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

fbc174a

Update docs_preview_deploy_cf.yaml

acdd992

Update cockroachdb-list-schemas.md

752bfd1

Update DEVELOPER.md

7a08ea6

Update _index.md

80581c2

Update cockroachdb-list-schemas.md

e99c337

docs: Update root folder names

8ca637a

update links and github header check

8904a82

dishaprakash and others added 6 commits March 23, 2026 16:21

rename client-sdks to toolbox-sdks

92247ac

update links

9f2a026

unedit samples-hub

61702f0

remove mcp quickstart from samples hub

bbc951a

update filter

6f197c0

Update _index.md

4f9ac4d

dishaprakash force-pushed the rename-root-folder branch from bb52471 to 4f9ac4d Compare March 23, 2026 16:23

dishaprakash merged commit 8b15e1c into documentation-reorg Mar 23, 2026
20 of 23 checks passed

dishaprakash deleted the rename-root-folder branch March 23, 2026 16:27

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: Update root folder names#2779

docs: Update root folder names#2779
dishaprakash merged 23 commits intodocumentation-reorgfrom
rename-root-folder

dishaprakash commented Mar 18, 2026 •

edited

Loading

Uh oh!

gemini-code-assist bot commented Mar 18, 2026

Uh oh!

github-actions bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

Uh oh!

github-actions bot commented Mar 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

dishaprakash commented Mar 18, 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 18, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

github-actions bot commented Mar 18, 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/documentation/connect-to/mcp-client/_index.md

Errors in docs/en/documentation/connect-to/toolbox-sdks/javascript-sdk/core/index.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

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

docs/en/documentation/connect-to/toolbox-sdks/go-sdk/core/_index.md (82-85)

docs/en/documentation/connect-to/toolbox-sdks/go-sdk/core/_index.md (104-106)

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

github-actions bot commented Mar 19, 2026

Uh oh!

Uh oh!

github-actions bot commented Mar 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

dishaprakash commented Mar 18, 2026 •

edited

Loading

github-actions bot commented Mar 18, 2026 •

edited

Loading