Skip to content

docs: migration of core package samples from go sdk#2330

Merged
AnmolShukla2002 merged 8 commits intomigrate-go-sdkfrom
migrate-go-sdk-core
Feb 5, 2026
Merged

docs: migration of core package samples from go sdk#2330
AnmolShukla2002 merged 8 commits intomigrate-go-sdkfrom
migrate-go-sdk-core

Conversation

@AnmolShukla2002
Copy link
Copy Markdown
Contributor

@AnmolShukla2002 AnmolShukla2002 commented Jan 19, 2026

This PR migrates the Go SDK documentation and core technical samples from the [mcp-toolbox-sdk-go] repository to the main genai-toolbox documentation site. This consolidation ensures that conceptual guides, package overviews, and interactive code examples are available in a centralized "one-stop-shop".

@AnmolShukla2002 AnmolShukla2002 requested a review from a team January 19, 2026 09:20
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @AnmolShukla2002, I'm Gemini Code Assist1! 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 enhances the documentation for the MCP Toolbox Go SDK's core package. It provides developers with a centralized and comprehensive resource for understanding the SDK's capabilities, from basic setup and tool interaction to advanced topics like secure authentication mechanisms and flexible parameter binding. Furthermore, it offers ready-to-use integration samples for leading AI orchestration frameworks, streamlining the development of intelligent applications using the Toolbox.

Highlights

  • Comprehensive Go SDK Documentation: Introduces a new, detailed documentation page for the MCP Toolbox Go SDK's core package, covering installation, usage, and advanced features.
  • Authentication Guides: Provides in-depth guidance on both client-to-server authentication (e.g., for Cloud Run deployments) and tool-level authentication, including token retrieval and configuration options.
  • Parameter Binding Functionality: Explains how to bind static or dynamic values to tool parameters, enhancing security and control over tool invocation.
  • Orchestration Framework Integration Samples: Includes practical code examples demonstrating how to integrate the Go SDK with popular AI orchestration frameworks like Google GenAI, LangChain Go, and OpenAI Go.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

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.

Footnotes

  1. 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.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds extensive documentation and samples for the Go SDK core package. The documentation is comprehensive, but I've found several issues in the code samples, including incomplete examples, incorrect API usage, unhandled errors, and typos. These issues could confuse users or cause their code to fail if they copy the examples. I've left specific comments with suggestions for fixes. Addressing these will greatly improve the quality and usability of the documentation.

Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

Copy link
Copy Markdown
Contributor

@anubhav756 anubhav756 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we have major sections added as separate pages under the SDKs' sections?

@anubhav756
Copy link
Copy Markdown
Contributor

There seem to be links to the READMEs of individual packages in the top-level doc (screenshot). Can we have them linked to this docsite?

Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@AnmolShukla2002
Copy link
Copy Markdown
Contributor Author

There seem to be links to the READMEs of individual packages in the top-level doc (screenshot). Can we have them linked to this docsite?

I guess docs reorganization strategy states that we will "treat each SDK repository as the source of truth for its own API reference". While the docsite serves as the "one-stop-shop" for conceptual guides, the github links serve as the technical reference point until our auto-generated API subdomains are fully live. I am not sure on this, let me know your thoughts?

@anubhav756
Copy link
Copy Markdown
Contributor

anubhav756 commented Jan 29, 2026

There seem to be links to the READMEs of individual packages in the top-level doc (screenshot). Can we have them linked to this docsite?

I guess docs reorganization strategy states that we will "treat each SDK repository as the source of truth for its own API reference". While the docsite serves as the "one-stop-shop" for conceptual guides, the github links serve as the technical reference point until our auto-generated API subdomains are fully live. I am not sure on this, let me know your thoughts?

Sounds good! Let’s link directly to the github source files until we have the API ref docsite up.

However for links like those under “Which package should I use?”, I guess I was assuming the links from core, tbadk and tbgenkit could be linked to the packages’ respective pages to the guidance docs that I assume we would be adding to the main docsite (just like we have done for the core package). Currently they seem to link to the github source code (unless it’s intentional because I see the core package guidance page is linked at the bottom of that page, but just thinking what if we also link the guidance pages in that section as well). Thoughts?

Copy link
Copy Markdown
Contributor

@anubhav756 anubhav756 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, given we address the bot comments and link checker error as well. Optionally, adding a PR description might help as well.

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

@AnmolShukla2002
Copy link
Copy Markdown
Contributor Author

There seem to be links to the READMEs of individual packages in the top-level doc (screenshot). Can we have them linked to this docsite?

I guess docs reorganization strategy states that we will "treat each SDK repository as the source of truth for its own API reference". While the docsite serves as the "one-stop-shop" for conceptual guides, the github links serve as the technical reference point until our auto-generated API subdomains are fully live. I am not sure on this, let me know your thoughts?

Sounds good! Let’s link directly to the github source files until we have the API ref docsite up.

However for links like those under “Which package should I use?”, I guess I was assuming the links from core, tbadk and tbgenkit could be linked to the packages’ respective pages to the guidance docs that I assume we would be adding to the main docsite (just like we have done for the core package). Currently they seem to link to the github source code (unless it’s intentional because I see the core package guidance page is linked at the bottom of that page, but just thinking what if we also link the guidance pages in that section as well). Thoughts?

yes made these changes!

@AnmolShukla2002
Copy link
Copy Markdown
Contributor Author

LGTM, given we address the bot comments and link checker error as well. Optionally, adding a PR description might help as well.

Bot's comments are mostly regarding the sample...I am not sure If I should make these changes as it would then defer from the sample in the Sdk repos?

@github-actions
Copy link
Copy Markdown
Contributor

Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/_index.md
@anubhav756 anubhav756 self-requested a review February 2, 2026 12:30
Comment thread docs/en/sdks/go-sdk/core/_index.md
Comment thread docs/en/sdks/go-sdk/core/_index.md Outdated
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 3, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 4, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 4, 2026

@anubhav756
Copy link
Copy Markdown
Contributor

LGTM, given we address the bot comments and link checker error as well. Optionally, adding a PR description might help as well.

Bot's comments are mostly regarding the sample...I am not sure If I should make these changes as it would then defer from the sample in the Sdk repos?

Can we apply any grammatical or any other minor suggestions from the bot, without affecting the functionality?

@AnmolShukla2002
Copy link
Copy Markdown
Contributor Author

LGTM, given we address the bot comments and link checker error as well. Optionally, adding a PR description might help as well.

Bot's comments are mostly regarding the sample...I am not sure If I should make these changes as it would then defer from the sample in the Sdk repos?

Can we apply any grammatical or any other minor suggestions from the bot, without affecting the functionality?

Okay sure!

@AnmolShukla2002 AnmolShukla2002 merged commit c8818ff into migrate-go-sdk Feb 5, 2026
12 of 13 checks passed
@AnmolShukla2002 AnmolShukla2002 deleted the migrate-go-sdk-core branch February 5, 2026 05:25
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 5, 2026

🧨 Preview deployments removed.

AnmolShukla2002 added a commit that referenced this pull request Feb 9, 2026
Related PRs : [Core]
#2330
[tbADK] #2393
[tbGenkit] #2394

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants