Skip to content

docs(docs-site): route users away from deprecated mcp-imagen-go - #1915

Merged
ghchinoy merged 1 commit into
GoogleCloudPlatform:mainfrom
marrionesa:docs/docs-site-imagen-deprecation
Oct 17, 2026
Merged

ghchinoy merged 1 commit into
GoogleCloudPlatform:mainfrom
marrionesa:docs/docs-site-imagen-deprecation

Conversation

@marrionesa

Copy link
Copy Markdown
Contributor

What

Applies the docs-site reference swaps flagged in the §3.1 audit of #1912
(follow-up as offered there), mirroring what dc48d1f6 already landed
in-tree:

  • agents/geminicli.md: the sample settings register nanobanana instead
    of imagen (mirroring sample-agents/geminicli/sample_settings.json);
    the troubleshooting section now uses live servers in its error examples,
    which checks and --help test, dropping the deprecated binary from the
    command enumeration; and the "Images Only" partial-extension note no
    longer claims it installs imagen
  • agents/adk.md: the "Start the Imagen MCP Server" instruction is
    replaced with a pointer to the current in-tree README — the sample was
    reworked to four all-stdio toolsets (nanobanana, chirp3, veo,
    avtool) and no longer starts a separate SSE server; the referenced
    binary is also excluded by install.sh, so the instruction was dead
  • index.md: the generic "running the servers" example now uses
    mcp-nanobanana-go
  • mcp-imagen-go/index.md: deprecation banner added (mirrors the in-tree
    README banner from docs(mcp-imagen-go): add deprecation banner and DEPRECATION.md audit #1912, with absolute links since DEPRECATION.md
    lives in-tree)

Why

The hand-maintained docs-site still routes new users to the deprecated
mcp-imagen-go server while the in-tree samples were already swapped.
Users following the published docs today receive a dead path twice over:
the binary is excluded by install.sh, and the Imagen endpoints return
HTTP 404 since 2026-08-17 (documented in experiments/agent_tools).

Scope notes

  • docs-site/astro.config.mjs sidebar intentionally untouched — the page
    remains published, now carrying the banner

  • The two CI entries (build loop, publish matrix) intentionally untouched —
    per the §3.1 classification they travel with the directory-removal PR
    whenever that is agreed

  • agents/adk.md deliberately points at the current in-tree README instead
    of re-documenting the reworked architecture, which the maintainers may
    prefer to describe themselves

  • Remaining "Imagen" mentions in index.md (capabilities list, servers list,
    resource-link scope) intentionally untouched — the §3.1 audit flagged only
    the user-routing examples and the un-bannered server page; whether the
    servers-list entry needs its own deprecation marker is part of the broader
    docs-cleanup decision on Scope: deprecate Imagen references across genmedia #1588

References #1588. Follow-up to #1912.

@marrionesa
marrionesa requested review from a team, awaemmanuel and ghchinoy as code owners September 22, 2026 23:05
@ghchinoy
ghchinoy merged commit 0a6b578 into GoogleCloudPlatform:main Oct 17, 2026
6 checks passed
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.

2 participants