[DOCS] Plugin marketplace docs omit Git submodule-backed plugin source support

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/plugin-marketplaces

Section/Topic

Plugin sources stored in Git submodules and /plugin marketplace update behavior.

Current Documentation

The plugin source schema currently says:

| Relative path | string (e.g. "./my-plugin") | - | Local directory within the marketplace repo. Must start with ./ |

The command docs currently say:

/plugin marketplace update marketplace-name

The plugin caching docs also say:

Plugins are specified in one of two ways: Through claude --plugin-dir, for the duration of a session. Through a marketplace, installed for future sessions.

No documentation currently explains whether marketplace plugin sources may live inside Git submodules or how marketplace updates handle them.

What's Wrong or Missing?

Release v2.1.74 says marketplace updates now sync Git submodules so plugin sources inside submodules no longer break after update.

That implies Git submodule-backed plugin sources are a supported marketplace layout, but current docs do not say whether this arrangement is supported, how it interacts with relative-path sources, or what /plugin marketplace update does for submodules.

Suggested Improvement

Add a note in plugin marketplace docs and troubleshooting that covers:

1. Submodule-backed plugin sources are supported.
2. /plugin marketplace update syncs those submodules.
3. When to use a submodule versus a direct Git/GitHub/npm source.
4. Any caveats for cache behavior or nested repository layouts.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/plugin-marketplaces | 220-224, 830-849 | Relative-path plugin sources and troubleshooting are documented, but submodules are never mentioned |
| https://code.claude.com/docs/en/discover-plugins | 332-335 | /plugin marketplace update is documented without submodule behavior |
| https://code.claude.com/docs/en/plugins-reference | 381-386 | Marketplace-installed plugin/cache behavior is documented, but not submodule-backed sources |

Total scope: 3 pages affected

Source: Release v2.1.74

• Fixed marketplace update not syncing git submodules — plugin sources in submodules no longer break after update