Commit Graph

10064 Commits (feat-api-uplift)

Author SHA1 Message Date
Jason Stirnaman 4f430457cb refactor(api): replace hardcoded product configs with auto-discovery
Replace the 110-line productConfigs map with auto-discovery from
.config.yml files. The generation script now derives Hugo paths,
menu keys, and static file names from directory structure and
existing frontmatter.

Key changes:
- discoverProducts() scans api-docs/ for .config.yml files
- Each API entry generates independently (no mergeArticleData)
- New frontmatter params: specDownloadPath, articleDataKey, articleSection
- Templates use frontmatter lookup instead of hardcoded URL-to-key maps
- list.html download button simplified from 50 lines to 5
- Cypress tests updated for Hugo-native-only URLs
2026-03-15 17:01:27 -05:00
Jason Stirnaman 313fca7294 style(api): refine code samples, schema examples, and layout width
- Move Ask AI link to header bar alongside Example request title
- Use theme-aware variables for code block backgrounds and colors
- Fix schema example blocks: separate header bar from code content
- Normalize description font sizes to inherit page base size
- Keep inline code font-size proportional with font-size: inherit
- Widen API content wrapper to match regular article width (~850px)
- Remove TOC border-left at compressed viewport widths (1281-1535px)
2026-03-10 14:16:55 -05:00
Jason Stirnaman f061004c50 style(api): move Ask AI link below code block with theme-aware styling
Position the Ask AI link in a footer bar below the code sample instead
of overlaying it on the code block. Use site theme colors instead of
hardcoded values.
2026-03-09 22:12:53 -05:00
Jason Stirnaman 32b64f3d7d task(plans): organize 2026-03-09 21:47:45 -05:00
Jason Stirnaman df9c9977cf feat(api): add inline curl examples and Ask AI links to API operations
Generate curl examples at Hugo template time from OpenAPI specs, with
server URL variable resolution, $ref handling, and JSON body generation
from schema properties. Add "Ask AI about this example" links using
existing Kapa integration. Add client library related link to all
InfluxDB 3 API tag pages. Improve visual separation between operations
with distinct badge colors and response body indentation.
2026-03-07 23:00:22 -06:00
Jason Stirnaman 895d56058d Merge remote-tracking branch 'origin/claude/api-code-samples-plan-MEkQO' into docs-v2-pr6622 2026-03-07 17:17:35 -06:00
Claude 0e1b8003c0
docs(plan): add API code samples, Ask AI, and client library integration design
Covers 4 phases: inline curl examples from OpenAPI specs, response body
schema rendering, Ask AI on code blocks, and client library integration
with tabbed language samples for write/query operations.

https://claude.ai/code/session_01P1FJ4g1aQmSmQAH9BCmKZr
2026-03-07 23:13:34 +00:00
Jason Stirnaman 00f0578677 fix(api): add scroll highlighting to server-rendered TOC
The server-rendered TOC path returned early without setting up the
IntersectionObserver, so the is-active class was never applied to
TOC links during scroll. Extract entry IDs from pre-rendered links
and pass them to setupScrollHighlighting.
2026-03-06 16:18:11 -06:00
Jason Stirnaman fc1f93680b style(api): use Redocly anchor format and flatten operation layout
- Switch operation anchors from {method}-{path} to
  operation/{operationId} (PascalCase), matching Redocly convention
  and existing content links like #operation/PutPluginFile.
  Updated in Hugo templates, all-endpoints list, and JS TOC.

- Remove nested bordered containers from API operations. Operations
  separated by top-border dividers instead of card wrappers. Param
  lists, schema properties, and responses no longer wrapped in
  bordered boxes.

- Replace CSS custom properties (var(--article-text, ...)) with SCSS
  theme variables ($article-text, $article-heading, $nav-border, etc).
  The CSS vars were never defined in this theme, so all text fell back
  to hardcoded dark-gray values invisible in dark mode.

- Delete entire dark mode override section — now handled automatically
  by Hugo's per-theme SCSS compilation.

- Add border-bottom divider to operation endpoint line for visual
  separation from the operation heading.

- Update PLAN.md to mark Task 7 as completed.
2026-03-06 14:35:54 -06:00
Jason Stirnaman f58abb6971 Merge remote-tracking branch 'origin/master' into docs-v2-pr6622
# Conflicts:
#	.github/copilot-instructions.md
#	layouts/shortcodes/latest-patch.html
2026-03-06 12:12:58 -06:00
Jason Stirnaman 765f669d06
feat(influxdb3): document --checkpoint-interval serve option (#6896)
* feat(influxdb3): document --checkpoint-interval serve option

Add documentation for the previously undocumented --checkpoint-interval
flag, which aggregates WAL snapshot files into monthly checkpoint files
to significantly reduce server startup time.

Changes:
- config-options.md: add checkpoint-interval entry in the WAL section,
  including description, default (disabled), env var, and usage example
- performance-tuning.md: add "Startup optimization" section explaining
  the startup-time tradeoff and recommended intervals by scenario

Closes #6884

https://claude.ai/code/session_01BArJYJTXBsUjNcdTJVyg6v

* docs(influxdb3): add version metadata to checkpoint-interval heading (#6897)

* Initial plan

* feat(influxdb3): add version metadata to checkpoint-interval heading

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>

* Apply suggestions from code review

* fix(workflows): trigger pr-preview on ready_for_review event (#6898)

* Initial plan

* fix(workflows): trigger pr-preview on ready_for_review event

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>

* Update content/shared/influxdb3-cli/config-options.md

* fix(influxdb3): remove WAL snapshot conflation and add release note

- Replace "WAL snapshot files" with "snapshots" shorthand, linking to
  backup-restore file structure on first use
- Simplify "snapshot files"→"snapshots" and "checkpoint files"→"checkpoints"
  throughout checkpoint-interval and startup optimization sections
- Add checkpoint-interval feature to v3.8.2 release notes

Addresses review feedback from #6896.

* Update content/shared/influxdb3-cli/config-options.md

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2026-03-06 08:11:11 -06:00
Copilot 3f34f43627
Fix line break between `influxdb3` and "CLI" in write-data intro (#6902)
* Initial plan

* Remove line separation between influxdb3 and CLI in write-data page

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>
2026-03-04 11:52:42 -06:00
Jakub Bednář fb4d8722a8
Release Kapacitor v1.8.3 (#6899) 2026-03-03 08:09:38 -06:00
Copilot 618fc48e3e
Fix broken fragment links in Chronograf v1.11.0 release notes (#6864)
* Release Chronograf v1.11.0

* fix: warning format

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Initial plan

* Fix 6 broken links in Chronograf release notes

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Fix all 6 broken links in Chronograf release notes with correct fragment IDs

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: Jakub Bednář <jakub.bednar@gmail.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
2026-03-02 11:15:32 -06:00
Copilot 6b7921ea1e
Add INFLUXDB3_ prefixes to CLI environment variables with deprecation notes (#6865)
* Initial plan

* Add INFLUXDB3_ prefixes and deprecation notes to environment variables

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>
2026-03-02 11:02:10 -06:00
Jason Stirnaman c9708a18fa
chore(spell-check): improve Vale spell checking for code comments (#6876)
* chore(spell-check): improve Vale spell checking for code comments

- Enable spell checking in code blocks by removing ~code exclusion from InfluxDataDocs Spelling rule
- Add comprehensive filters to avoid false positives from:
  - camelCase and snake_case identifiers
  - hexadecimal values and version numbers
  - URL paths and URLs
  - shortcode attributes
  - code punctuation and symbols
- Fix spelling errors in code comments:
  - "includimng" → "including" in 3 files
  - "continously" → "continuously" in 5 files

This allows Vale to catch typos and spelling mistakes in code comments and documentation strings while avoiding false positives on actual code syntax and identifiers.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* chore(spell-check): add codespell configuration

- Add .codespellrc with 'clear' builtin dictionary to catch unambiguous spelling errors
- Add .codespellignore for technical terms and product names
- Configuration prevents false positives while enabling comprehensive spell checking for code comments

This enables codespell for automated spell checking via CI/CD, complementing the Vale configuration.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* fix(reference): correct 6 spelling errors across reference pages

Fixes identified through codespell analysis of reference documentation:

- influxdb/v2/config-options: useable → usable
- influxdb3/clustered/release-notes: provid → provide, certficate → certificate, memeory → memory, Geting → Getting
- kapacitor/v1/release-notes: auotmatically → automatically

Note: "invokable" is excluded as a branding term; "fpr" in GPG code is a legitimate field name.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* docs(spell-check): improve validation rules and documentation

Core improvements to spell-checking rules:

CODESPELL CONFIGURATION (.codespellrc):
- Use only 'clear' dictionary (removes 'rare', 'code' for fewer false positives)
- Add 'api-docs' to skip list (avoids false positives in generated specs)
- Add 'invokable' to ignore list (product branding term)
- Remove unclear 'tage' term
- Add documentation explaining each setting

VALE CONFIGURATION (Spelling.yml):
- Expand scope documentation explaining why code blocks are included
- Add comprehensive comments for each filter pattern
- Include examples for each regex pattern
- Document limitations and edge cases
- Organize filters by category (branding, URLs, code, literals)

NEW DOCUMENTATION (SPELL-CHECK.md):
- Tool comparison and use cases
- Detailed explanation of each filter pattern
- Troubleshooting guide
- Running instructions for both tools
- Contribution guidelines
- References and related files

These changes ensure:
 Minimal false positives (8.5-9/10)
 Strong true positive detection (8.5-9.5/10)
 Clear, maintainable rules
 Easy to extend and modify
 Well-documented for team use

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* refactor(spell-check): consolidate ignore words to single source

Consolidate duplicate ignored words configuration:

BEFORE:
- .codespellignore: AKS, aks, invokable, tagE
- .codespellrc: inline ignore-words-list = aks,invokable
- Problem: Maintenance duplication and confusion

AFTER:
- .codespellignore: authoritative list (aks, AKS, invokable with docs)
- .codespellrc: references .codespellignore via 'ignore-words' config
- Benefit: Single source of truth, cleaner configuration

Also removed:
- 'tagE' from ignore list (unclear, possibly a typo)
- Inline word list from .codespellrc (now external)

This follows codespell best practices and reduces maintenance burden.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* docs(spell-check): correct version number regex documentation

Fix incorrect limitation note in SPELL-CHECK.md:

The regex pattern \d+\.\d+(?:\.\d+)* actually DOES match
4-part versions like 1.2.3.4 (and any number of parts).

The (?:\.\d+)* part is a repeating group that matches
zero or more additional dot-separated version components.

Updated documentation to clarify that the pattern handles
any number of version parts, not just 2-3 part versions.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* Update SPELL-CHECK.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(spell-check): tighten camelCase regex to prevent false negatives

The original camelCase regex pattern was too permissive and would match
any word starting with lowercase (e.g., 'provide', 'database', 'variable'),
causing Vale to skip spell-checking normal prose words.

Improved pattern now requires:
- camelCase: at least one uppercase letter (myVariable ✓, provide ✗)
- snake_case: at least one underscore (my_variable ✓, variable ✗)

This prevents common prose words from being silently excluded from
spell-checking while still properly handling code identifiers.

Combined pattern: (?:_*[a-z]+(?:[A-Z][a-z0-9]*)+(?:[A-Z][a-zA-Z0-9]*)*|[a-z_][a-z0-9]*_[a-z0-9_]*)

Updated files:
- SPELL-CHECK.md: Added detailed explanation and test cases
- .ci/vale/styles/InfluxDataDocs/Spelling.yml: Updated filter pattern

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

* fix(spell-check): expand URL scheme pattern to match documentation comment

The comment said the URL filter ignores 'http, https, ftp, etc.' but the
regex only matched http and https. Expanded the pattern to match:

- http/https (as before)
- ftp/ftps (file transfer protocols)
- ssh (secure shell)
- file (local file URLs)

Updated pattern: (?:https?|ftp|ftps|ssh|file)://[^\s\)\]>"]+

This ensures the filter matches the documented behavior.

https://claude.ai/code/session_01TYWR7wb5MUkzjVsK4mtNjA

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-28 14:24:23 -06:00
Jason Stirnaman 54cc064063
feat(ci): add ShellCheck linter to Lefthook pre-commit hooks (#6891)
* feat(ci): add ShellCheck linter to Lefthook pre-commit hooks

Add shell script linting via ShellCheck to catch common bugs (unquoted
variables, missing error handling, POSIX portability issues) before commit.

- Create `.shellcheckrc` with project-wide defaults (disable SC1091, SC2154)
- Create `.ci/shellcheck/shellcheck.sh` wrapper (local binary → Docker fallback)
- Add `shellcheck` pre-commit hook in `lefthook.yml` with glob/exclude patterns

Lints 23 infrastructure scripts (test, CI, deploy, helpers) while excluding
36 documentation example scripts in `shared/text/` and `layouts/shortcodes/`.

https://claude.ai/code/session_01X2gknrNvC5GGNExHU93FG6

* Update .shellcheckrc

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(ci): derive shellcheck minimum version from pinned version

Single source of truth — the minimum local version is now parsed from
SHELLCHECK_VERSION instead of being maintained as separate constants.
This prevents drift between the Docker image version and the local
binary requirement.

https://claude.ai/code/session_01X2gknrNvC5GGNExHU93FG6

* fix(ci): remove unused external-sources from .shellcheckrc

external-sources=true only takes effect with the -x flag, which the
wrapper doesn't pass. Source-following isn't needed for pre-commit
linting of individual files, and SC1091 is already disabled.

https://claude.ai/code/session_01X2gknrNvC5GGNExHU93FG6

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-28 12:39:59 -06:00
Jason Stirnaman f7fbdbdea8
fix: add content links and InfluxDB documentation MCP server instructions (#6885)
* fix: link resource terms

* chore(aagents): Allow use of yq and htmlq for parsing.

* chore(deps): yarn upgrade

* chore(deps): remove unused @vvago/vale npm package

Vale linting uses Docker (jdkato/vale:latest) via .ci/vale/vale.sh,
not the npm package. Update VS Code setup docs to use system Vale.

* docs(skill): update content-editing skill for hosted MCP server

Replace local InfluxData MCP server references with the hosted kapa.ai
documentation MCP server (https://influxdb-docs.mcp.kapa.ai).

Changes:
- Update MCP configuration from local stdio server to hosted URL
- Replace kapa_query() examples with natural language prompts
- Add rate limit info (40/hour, 200/day per Google OAuth user)
- Standardize Hugo commands to use yarn (yarn hugo --quiet)
- Fix E2E test command (node cypress/support/run-e2e-specs.js)
- Use .ci/vale/vale.sh consistently for Vale linting
- Remove VS Code-specific instructions for agent focus
- Move TODOs to GitHub issue #6853

* chore(deps): yarn upgrade

* Apply suggestions from code review

* Update .claude/skills/content-editing/SKILL.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update .claude/skills/content-editing/SKILL.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(ci): fix Vale linting setup and add dependency update checks

The vale Compose service was removed in 922e4818 but docs still
referenced `docker compose run -T vale`, which fails.

Vale linting now works as follows:

- If vale is installed locally (v3+), .ci/vale/vale.sh uses it directly.
  Contributors can install via `brew install vale` for faster linting
  without Docker.
- Otherwise, the script falls back to Docker with a pinned image tag
  (jdkato/vale:v3.13.1) instead of :latest.
- If the local version is incompatible (pre-v3), the script warns and
  falls back to Docker.

Docker is no longer required for pre-commit hooks that only run Vale.

Also adds a weekly GitHub Actions workflow (check-pinned-deps.yml) that
compares pinned dependency versions against upstream releases and opens
a PR when updates are available.

* Update .ci/vale/vale.sh

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update .github/workflows/check-pinned-deps.yml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix: resolve code review findings for PR #6885

- vale.sh: make version-detection grep non-fatal so Docker fallback works
- check-pinned-deps: add set -euo pipefail, auth header, and null guards
- DOCS-CONTRIBUTING: fix broken links to DOCS-TESTING.md
- DOCS-TESTING: rename VS Code section heading per review suggestion

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-28 09:12:48 -06:00
ritwika314 5fe6e6287e
docs: add autoscaling configuration guide for InfluxDB Cloud Dedicated (#6881)
* docs: add autoscaling configuration guide for InfluxDB Cloud Dedicated

* fix: correct frontmatter delimiter and trailing whitespace in autoscaling.md (#6882)

* Initial plan

* fix: add missing frontmatter delimiter and remove trailing whitespace

Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

* docs: refine autoscaling documentation for clarity and detail

* docs: refine autoscaling documentation for clarity and detail

* docs: enhance clarity and detail in autoscaling documentation

* [WIP] Add autoscaling configuration guide for InfluxDB Cloud Dedicated (#6886)

* Initial plan

* fix: remove trailing whitespace and re-enable Vale.Terms rule in autoscaling.md

Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

* Apply Jason's suggestions

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Apply suggestion from @jstirnaman

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-27 21:31:29 -06:00
Jason Stirnaman 8035366677
refactor: replace URL-parsing in shortcodes with cascade product data (#6883)
* chore: add .worktrees to gitignore

* refactor: replace URL-parsing in shortcodes with cascade product data

Replace duplicated URL-parsing logic across 28 shortcodes with Hugo's
cascade frontmatter. Each product section's _index.md now cascades
`product` (data key) and `version` (URL segment) to all descendants.

Key changes:
- Add cascade frontmatter to 15 product _index.md files
- Create layouts/partials/product/get-data.html shared partial
- Refactor 28 shortcodes to use the partial instead of parsing URLs
- Add version_label, limits, and distributed_architecture metadata
  to data/products.yml to eliminate hardcoded dicts in shortcodes
- Fix lefthook lint-markdown-instructions glob format (YAML array)
- Fix pre-existing Vale exclamation point errors in cloud and v2

* fix: prevent remark-lint from escaping Hugo template syntax in shortcodes

Lefthook's glob option only triggers whether a command runs — it does
not filter {staged_files}. This caused remark-lint to process .md
shortcode files in layouts/, escaping underscores, brackets, and
parentheses that are valid Hugo template syntax.

Add layouts/ exclusion to the existing content/ filter in the
lint-markdown-instructions run command. Also fix the 3 shortcode files
that were damaged by remark-lint in the previous commit.

* test: add E2E tests for cascade product shortcodes

Add Cypress tests validating all refactored shortcodes across 14
product/version combos (82 tests). Test expectations are derived
from products.yml at runtime via cy.task('getData').

Fix the product links test to iterate actual home page links
instead of all products.yml entries.

Create _test/shortcodes.md pages in each product section
exercising product-name, product-key, current-version,
influxdb/host, and InfluxDB3-specific shortcodes.

* test: expand E2E coverage to 27 of 28 cascade shortcodes

Add shortcode invocations to all 14 test pages and corresponding
Cypress assertions for version lookups, namespace URLs, product
name text, placeholder_host, version visibility, CTA links, and
site-level data.

Add shortcodes-real-pages.cy.js for 6 shortcodes that require real
page context (cli/mapped, children, flux/list-all-functions,
telegraf/plugins, html-diagram/sso-auth-flow, cli/influxd-flags).

Suppress Vale on test pages — they contain only shortcode syntax,
not prose.

163 tests total, all passing.

* refactor(test): rename _test dirs to __tests__ and add noindex

Rename test page directories from _test to __tests__ to align with
JS testing conventions. Add noindex: true to all 14 test page
frontmatter to prevent search engine indexing in production.
Update Cypress URL pattern to match new paths.
2026-02-27 09:46:57 -06:00
ritwika314 784a720d8b
docs: update 2025 product highlights and add January 2026 features (#6873)
* docs: update 2025 product highlights and add January 2026 features

* Update content/influxdb3/cloud-dedicated/reference/release-notes/cloud-dedicated.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/influxdb3/cloud-dedicated/reference/release-notes/cloud-dedicated.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix grammar, formatting, and capitalization in Cloud Dedicated release notes (#6874)

* Initial plan

* Fix grammar, capitalization, and trailing whitespace in cloud-dedicated release notes

Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>

* changed update order: most recent to oldest.  January 2026 product highlights in Cloud Dedicated release notes

* Apply Jason's suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ritwika314 <3454653+ritwika314@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-27 09:17:41 -06:00
Jason Stirnaman 91a7299ef7 docs(plan): mark Task 7 (clean regeneration) as completed 2026-02-26 23:13:20 -06:00
peterbarnett03 f267c93f3b
chore: add release notes for InfluxDB 3.8.3 (#6877)
* chore: add release notes for InfluxDB 3.8.3

Added release notes for version 3.8.3, including a bug fix for the WAL Buffer.

* Apply suggestion from @sanderson

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* chore: add release notes for InfluxDB 3.8.3 (#6879)

* Initial plan

* chore: bump core and enterprise to 3.8.3 in products.yml

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>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
2026-02-26 10:38:10 -06:00
ritwika314 c00e301bcc
Add documentation for query log in cloud dedicated (#6866)
* Add documentation for viewing the query log in the Admin UI and using influxctl

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Replace deprecated code-placeholders shortcode with placeholders attribute (#6869)

* Initial plan

* Replace deprecated code-placeholders shortcode with placeholders attribute

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>

* Fix support.influxdata.com link pattern in query-log.md (#6867)

* Initial plan

* Fix support link pattern and add enforcement check

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Remove validation changes, keep content fix only

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>

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Clarify note on query log enabling and its impact on cluster load per @jeffreyssmith2nd 's suggestion

* Add schema table with explicit data types for query_log fields (#6868)

* Initial plan

* Add comprehensive schema table for query_log fields with data types and descriptions

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>

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

* Update content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-log.md

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
2026-02-25 16:20:30 -06:00
Daniel Campbell ec564e3d7b
docs: backfill Explorer UI release notes (#6855)
* docs: backfill release notes

* docs: add release notes for v1.6.3

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-25 11:30:26 -06:00
Copilot 6b2db1b0b5
[WIP] Upgrade to ESLint v10 (#6861)
* Initial plan

* Update @eslint/js to v10.0.1 to match ESLint v10

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>
2026-02-25 11:01:24 -06:00
Jason Stirnaman a609a3f900
docs(influxdb3): document how to disable Processing Engine (#6860)
* docs(influxdb3): document how to disable Processing Engine

Add documentation for disabling the Processing Engine in Docker and
systemd deployments. Key points:

- Processing Engine is enabled by default in Docker images and DEB/RPM
- Empty string does not disable — must unset or remove config
- Enterprise: use INFLUXDB3_UNSET_VARS feature
- Core Docker: requires custom entrypoint workaround
- systemd: comment out or remove plugin-dir from TOML config

closes influxdata/DAR#590

* docs(influxdb3): add cross-references for Processing Engine defaults

Add notes and cross-references explaining that the Processing Engine
is enabled by default in Docker and DEB/RPM installations:

- plugins/_index.md: Add deployment behavior table and link to disable docs
- get-started/processing-engine.md: Add note with cross-reference

* docs(influxdb3): clarify Processing Engine vs process mode distinction

Add notes explaining that --plugin-dir (Processing Engine activation) and
--mode=process (cluster node specialization) are independent configurations.

* docs(influxdb3): document --plugin-dir auto-enables process mode

- Update clustering, get-started, plugins, and reference pages
- Add example for enabling Processing Engine without --mode=process
- Clarify --mode=process is only needed for dedicated process-only nodes
- Synthesize notes into inline content for better flow in guides

* Update content/shared/influxdb3-reference/influxdb3-processing-engine.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/shared/influxdb3-cli/config-options.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-25 10:47:03 -06:00
Maya Strandboge b5a2425a28
Telegraf v1.37.3 (#6863)
* Updating changelog

* Updating product version

* Updating plugins

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-25 10:06:18 -06:00
Jason Stirnaman 18e996f644
v3.8.2 API and CLI updates (#6774)
* fix(influxdb3): update to v3.8.2, add --tls-no-verify and release notes

- Update latest_patch to 3.8.2 for Core and Enterprise in products.yml
  (3.8.1 was internal-only)
- Add --tls-no-verify and INFLUXDB3_TLS_NO_VERIFY env var to all
  remaining CLI pages (query, write, show, enable, disable, update,
  test, stop, create/delete cache and file_index commands)
- Add safety disclaimer: "Not recommended in production" per review
- Standardize --tls-ca description across all CLI pages
- Add v3.8.2 release notes for Core and Enterprise

Addresses review feedback from hiltontj and jstirnaman on PR #6774.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore(influxdb3): remove PachaTree references from documentation

Remove all PachaTree-related content that is not yet ready for
public documentation:
- Remove --use-pacha-tree from Enterprise serve CLI reference
- Replace influxdb3_pacha_tree log filter example with influxdb3_enterprise
- Remove influxdb3_pacha_tree from component names table
- Remove PachaTree storage engine entry from v3.7.0 release notes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Update content/shared/v3-core-enterprise-release-notes/_index.md

* Apply suggestions from code review

---------

Co-authored-by: peterbarnett03 <peter.barnett03@gmail.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2026-02-24 18:12:21 -06:00
Jakub Bednář 3606b03e7d
Release Chronograf v1.11.0 (#6854)
* Release Chronograf v1.11.0

* fix: warning format

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-24 10:19:18 -06:00
Jason Stirnaman d68ea2a933
docs(sql): add FLOAT/REAL type casting and precision info (#6856)
- Add FLOAT and REAL to numeric types table
- Document precision differences (~7 vs ~15 significant digits)
- Add warning about precision loss when casting to FLOAT
- Note PostgreSQL behavior difference

Note: DAR-584 referenced Cloud Dedicated, but this behavior is shared
across all InfluxDB 3 products via DataFusion SQL engine.

Closes DAR-584
2026-02-24 10:05:49 -06:00
Jason Stirnaman 61161cc280
feat(ent3): add experimental badge for --use-pacha-tree (#6857)
* fix(ent3): Add link target and experimental caution for PachaTree option.

* feat(ent3): add experimental badge for --use-pacha-tree

Document the experimental PachaTree storage engine option with a
styled badge and caution callout. Add reusable .badge.experimental
class using the existing caution color palette for light/dark modes.

- Add experimental badge to serve options table and config-options
- Add badge theme variables referencing $article-caution-* colors
- Use custom heading ID to preserve #use-pacha-tree anchor
2026-02-23 14:58:35 -06:00
Scott Anderson f68d591f6d hotfix(telegraf-controller): fix table formatting in install doc 2026-02-19 16:19:12 -07:00
Jason Stirnaman ff8a63aad0 build(api): rebuild compiled generation scripts 2026-02-18 19:54:59 -06:00
Jason Stirnaman 237630ffdb docs(api): update script header with new flags 2026-02-18 19:54:47 -06:00
Jason Stirnaman f79e108262 feat(api): add dry-run mode to main function 2026-02-18 19:52:50 -06:00
Jason Stirnaman 299631e767 feat(api): integrate cleanup into processProduct 2026-02-18 19:50:38 -06:00
Jason Stirnaman 70e9f18497 feat(api): add showDryRunPreview function 2026-02-18 19:49:24 -06:00
Copilot ba28e124b1
Add Documentation MCP server pages to chronograf, kapacitor, flux, and explorer (#6833)
* 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>
2026-02-18 14:20:26 -06:00
Jason Stirnaman b4a0eea0a3
feat: add InfluxDB documentation MCP server integration (#6830)
* chore(deps): update yarn dependencies

Run yarn to update lockfile with latest compatible versions.

* feat: add InfluxDB documentation MCP server integration

- Enable MCP widget in Ask AI (data-mcp-enabled, data-mcp-server-url)
- Restructure mcp-server.md with anchor TOC for database and docs MCP
- Add documentation MCP server page for products without database MCP:
  - cloud-serverless, clustered, v2, cloud (TSM), telegraf
  - Place in Reference section (or telegraf_v1_ref menu)
- Add shared content file for docs-only MCP server
- Add "Connect to documentation MCP" link in format-selector dropdown
- Add related MCP links to all get-started/setup pages

* fix: correct JSON syntax and product-aware MCP docs URL

- Fix JSON syntax errors in Cloud Dedicated config examples (= → :)
- Add missing comma in Docker args array for local server config
- Make format-selector MCP docs URL product-aware using Hugo path detection

* docs: add MCP pages for v1 products, fix menu, add screenshot

- Fix cloud-serverless identify-version menu parent to "Administer InfluxDB Cloud"
- Add MCP server pages for influxdb/v1 and enterprise_influxdb/v1 in Tools menu
- Update format-selector with v1 and enterprise_influxdb/v1 MCP docs paths
- Add MCP tool search screenshot showing search_influxdb_knowledge_sources

* Update content/influxdb3/cloud-serverless/get-started/setup.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/telegraf/v1/mcp-server.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-17 20:42:56 -06:00
Jason Stirnaman 33705b85b5 feat(api): add cleanProductOutputs function 2026-02-17 17:04:22 -06:00
Jason Stirnaman ef97d21dd0 feat(api): add getCleanupPaths function 2026-02-17 17:02:59 -06:00
Jason Stirnaman 91bdc16386 feat(api): add --no-clean and --dry-run CLI flags 2026-02-17 17:00:48 -06:00
Jason Stirnaman c37a47b722 docs(plan): add API clean regeneration implementation plan
10 bite-sized tasks for implementing --no-clean and --dry-run flags
in generate-openapi-articles.ts.
2026-02-17 16:54:44 -06:00
Jason Stirnaman 74e0de7521 docs(plan): add API clean regeneration design
Design for --clean/--no-clean/--dry-run flags in generate-openapi-articles.ts
to prevent stale files when tags are renamed or removed.
2026-02-17 16:53:23 -06:00
Jason Stirnaman c97428b600
fix(influxdb3): correct Quix Streams guide for Cloud Dedicated (#6828)
* chore(deps): update yarn dependencies

Run yarn to update lockfile with latest compatible versions.

* fix(influxdb3): correct Quix Streams guide for Cloud Dedicated

Extract downsample-quix content to shared file and fix product-specific
terminology, links, and prerequisites for Cloud Dedicated and Clustered.

- Use "database" terminology for Cloud Dedicated/Clustered
- Remove Docker from prerequisites (not used in guide)
- Add alt_links for cross-product navigation
- Fix broken TOC anchor links
- Add links to admin pages for tokens and databases
- Remove incorrect /reference/regions link for Cloud Dedicated
- Add lint rules for deprecated code-placeholders and py fence

Closes #6825

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(influxdb3): fix broken code blocks in Quix Streams guide

Code blocks inside show-in shortcodes were missing closing fences,
causing the markdown to render incorrectly. Added proper fence
boundaries and placeholder key documentation for each code section.

Also adds TODO to content-editing skill about improving automation
for code-placeholder-key workflow.

* Docs v2 docs v2 pr6828 (#6829)

* fix(influxdb): Rename to match other pages. Remove alt_links

* chore(deps): bump ESLint to 10.0.0

* Update content/shared/v3-process-data/downsample/quix.md

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-17 15:23:16 -06:00
dependabot[bot] 6c91e8d222
chore(deps): bump qs from 6.14.1 to 6.14.2 (#6823)
Bumps [qs](https://github.com/ljharb/qs) from 6.14.1 to 6.14.2.
- [Changelog](https://github.com/ljharb/qs/blob/main/CHANGELOG.md)
- [Commits](https://github.com/ljharb/qs/compare/v6.14.1...v6.14.2)

---
updated-dependencies:
- dependency-name: qs
  dependency-version: 6.14.2
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-17 09:40:22 -06:00
Muhammed Hussain Karimi d48c545531
Correct AWS_ACCESSKEY_ID to AWS_ACCESS_KEY_ID (#6824) 2026-02-15 17:41:28 -06:00
Jason Stirnaman 3a56561cfa style(api): remove RapiDoc styles and rename hugo-native to operations
Remove all RapiDoc-specific code from styles and JavaScript:
- Delete rapi-doc::part() CSS selectors from _api-layout.scss
- Delete dead auth modal styles from _api-security-schemes.scss
- Delete api-auth-input.ts component (RapiDoc "Try it" integration)
- Delete static/css/rapidoc-custom.css (unused)
- Remove setupRapiDocNavigation() from api-toc.ts
- Update comments to remove RapiDoc references

Rename _api-hugo-native.scss to _api-operations.scss since
Hugo-native is now the standard (not a POC).
2026-02-13 22:35:22 -06:00
Jason Stirnaman 242989b7db style(test): apply lint fixes to API reference tests 2026-02-13 15:07:54 -06:00