* Initial plan * feat: add Documentation MCP server pages to chronograf, kapacitor, flux, and explorer Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> * fix: update MCP page descriptions to include product names Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> * fix: resolve product-name shortcode for v1/v0 versioned products The shortcode previously only checked the second URL path segment to identify products, which works for InfluxDB 3 (/influxdb3/core/) but fails for older products where the second segment is a version number (/chronograf/v1/, /flux/v0/). Add namespace extraction (first path segment) and conditional logic to look up products by namespace when the version is v1 or v0. This fixes empty product names in meta descriptions for Chronograf, Telegraf, Kapacitor, Flux, and InfluxDB Enterprise v1. * feat: relocate v2/cloud MCP pages and add alt_links for cross-product navigation - Move MCP server pages from reference/ to tools/ for InfluxDB v2 and Cloud - Add alt_links frontmatter to all MCP pages for cross-product navigation - Use product-name shortcode in descriptions for consistency - Convert code-placeholders shortcode to fenced code block attributes - Update shared content to use version-agnostic URLs * Add multi-assistant installation instructions for documentation MCP server (#6836) * Initial plan * feat(mcp): add installation instructions for multiple AI assistants Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> * refactor(mcp): replace Cline and Windsurf with GitHub Copilot and OpenCode Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com> |
||
|---|---|---|
| .. | ||
| influxctl | ||
| influxdb-client-libraries-reference | ||
| influxdb-v2 | ||
| influxdb3 | ||
| influxdb3-admin | ||
| influxdb3-api-reference | ||
| influxdb3-cli | ||
| influxdb3-get-started | ||
| influxdb3-internals | ||
| influxdb3-internals-reference | ||
| influxdb3-plugins | ||
| influxdb3-query-guides | ||
| influxdb3-reference | ||
| influxdb3-sample-data | ||
| influxdb3-visualize | ||
| influxdb3-write-guides | ||
| influxql-v3-reference | ||
| sql-reference | ||
| v3-core-enterprise-release-notes | ||
| v3-distributed-admin-custom-partitions | ||
| v3-distributed-internals-reference | ||
| v3-process-data | ||
| README.md | ||
| _index.md | ||
| identify-version.md | ||
| v3-line-protocol.md | ||
README.md
Shared content
This section is for content shared across multiple products and versions.
The /shared/_index.md frontmatter marks the /shared directory (/content/shared) and its
children as draft so they don't get rendered independently when the site is built.
The content of each shared document is included and rendered in pages that reference the
file as a source in their frontmatter.
Use shared content
-
Create a new folder for the content in the
/content/shared/directory. -
Copy the markdown files into the new folder.
-
Remove any frontmatter from the markdown files in the shared directory. If the first line starts with a shortcode, add an HTML comment before the first line, otherwise Hugo will err.
-
In each of the files that use the shared content, add a source to the frontmatter that points to the shared markdown file—for example:
source: /shared/influxql-v3-reference/regular-expressions.md -
In the doc body, remove the shared Markdown text and add a comment that points to the shared file, in case someone happens upon the page in the repo--for example, in
/content/influxdb3/core/reference/influxql/regular-expressions.md, add the following:
//SOURCE is a comment anchor (recognized by the Comment Anchors editor extension)
to make the file path clickable.