docs(v1): shared influx-cli page, v1.13.0 version tags, release-note links - #7701
Open
jstirnaman wants to merge 5 commits into
Open
docs(v1): shared influx-cli page, v1.13.0 version tags, release-note links#7701jstirnaman wants to merge 5 commits into
jstirnaman wants to merge 5 commits into
Conversation
What changed Moves the duplicated `tools/influx-cli/use-influx-cli.md` page (v1 OSS and v1 Enterprise) into `content/shared/influxdb-v1/`, leaving frontmatter stubs with `source:` in both editions. Gates the v1.13.0 mTLS CLI flags (`-cert`, `-key`, `-root-ca`, `-insecure-certificate`, `-ignore-cert-sanity-checks`) to Enterprise with `show-in`, since Enterprise's `_index.md` confirms they're Enterprise-only. Also gates the backup/export links, since OSS and Enterprise use different page slugs (`backup_and_restore` vs `backup-and-restore`). Why Closes the `tools/influx-cli/use-influx-cli.md` entry in #7662's worklist for reconciling the remaining duplicated v1 pages. Impact Readers of both v1 editions get one maintained copy. OSS no longer falsely documents Enterprise-only mTLS client flags. Verification - npx hugo --quiet completes with no errors. - Rendered output checked per edition: OSS omits -cert/-key/-root-ca/ -insecure-certificate/-ignore-cert-sanity-checks and resolves backup links to backup_and_restore/; Enterprise includes the flags and resolves to backup-and-restore/.
What changed Links the v1.13.0 "SHOW MEASUREMENTS" release note bullet to the InfluxQL query language reference. Why Other Features bullets in the same release entry already link out; this one didn't. mTLS support, hardening-enabled, backup compression, and the broader config value formats aren't linked because none of those config options or flags are documented yet in administration/config.md or tools/influxd/backup.md. Verification - npx hugo --quiet completes with no errors.
…tion
What changed
Adds the {metadata="v1.13.0+"} tag to series-id-set-cache-max-size,
-target-hit-rate, and -shrink-conservatism in both editions' config
references, matching the tag already on user-write-bytes-enabled from
the same release. Also documents that series-id-set-cache-size must
be greater than 0 to use adaptive sizing, since a floor of 0 disables
the cache entirely regardless of the other adaptive settings.
Why
Code review of the v1.13.0 doc range flagged the missing version tag
as inconsistent (all four options shipped together) and the floor
interaction as an undocumented edge case in issue #7312's spec.
Verification
- npx hugo --quiet completes with no errors.
What changed Links the "-timeout" and "influxd-ctl backup" Features bullets in the Enterprise v1.13.0 release notes to their reference sections. The "influx-meta cleanup-shards" bullet stays unlinked — there's no influx-meta command reference in this repo yet. Why mTLS was already linked; the other three Features bullets weren't. Verification - npx hugo --quiet completes with no errors. - Rendered output confirms both anchors exist: id=override-the-default-timeout on influxd-ctl/_index.md and id=node-selection on influxd-ctl/backup.md.
Contributor
Vale Style Check Results
Errors (blocking)
Warnings (12)
❌ Check failed — fix 10 error(s) before merging. |
Contributor
Release version check
💡 Badge new features with the versionDocumenting a new feature? Add a version badge in the page frontmatter — the
For inline version text, use |
github-actions
Bot
added
product:shared
Contributor
🔗 Link Check Results — Link Check Bot❌ 12 broken link(s) found — fix them before merging.
Broken Links
|
| Source File | URL | Issue |
|---|---|---|
content/enterprise_influxdb/v1/about-the-project/release-notes/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
content/enterprise_influxdb/v1/administration/configure/config-data-nodes/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
content/enterprise_influxdb/v1/tools/influx-cli/use-influx-cli/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/query | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/debug | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/delete-v2-compatible | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/delete-v2-compatible | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/debug | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/debug | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/buckets-v2-compatible | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/about_the_project/release-notes/_index.md |
file:///home/runner/work/docs-v2/docs-v2/public/influxdb/v1/api/buckets-v2-compatible | File not found. Check if file exists and path is correct: File not found. Check … |
content/influxdb/v1/administration/config/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
content/influxdb/v1/tools/influx-cli/use-influx-cli/_index.md |
https://support.influxdata.com/ | Network error: SSL certificate not trusted. Use --insecure if site is trusted (e… |
Full details: workflow run summary and artifact. Last updated: 2026-08-25 14:30:46 UTC
Contributor
📦 PR Preview — Preview Bot
Changed pages (6)
Preview auto-deploys on push. Will be cleaned up when PR closes. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #7662 (influx-cli/use-influx-cli.md entry)
What changed
tools/influx-cli/use-influx-cli.md(v1 OSS + Enterprise) intocontent/shared/influxdb-v1/, leaving frontmatter stubs withsource:inboth editions. Gates the v1.13.0 mTLS CLI flags
(
-cert,-key,-root-ca,-insecure-certificate,-ignore-cert-sanity-checks) to Enterprise, since they're Enterprise-only.Gates the backup/export links, since OSS and Enterprise use different page
slugs (
backup_and_restorevsbackup-and-restore).{metadata="v1.13.0+"}tag toseries-id-set-cache-max-size,-target-hit-rate, and-shrink-conservatismin both editions' configreferences, matching the tag already on
user-write-bytes-enabledfromthe same release. Documents that
series-id-set-cache-sizemust begreater than
0to use adaptive sizing.SHOW MEASUREMENTS,-timeout,influxd-ctl backupnode selection) to their referencesections in both editions.
Why
The v1.13.0 doc set shipped without a shared copy of the influx-cli page,
inconsistent version tags on the adaptive-cache options, and several
Features bullets that didn't link anywhere.
/code-reviewagainst issues#7312 (TSI adaptive cache) and #7662 (shared-content migration) surfaced
these gaps.
Impact
Readers of both v1 editions get one maintained influx-cli page instead of
two drifting copies, and OSS no longer falsely documents Enterprise-only
mTLS client flags. Release-notes readers can jump straight to the relevant
reference docs for four more features.
Verification
npx hugo --quietcompletes with no errors.-cert/-key/-root-ca/-insecure-certificate/-ignore-cert-sanity-checksand resolves backup links to
backup_and_restore/; Enterprise includes theflags and resolves to
backup-and-restore/.id=override-the-default-timeoutoninfluxd-ctl/_index.mdandid=node-selectiononinfluxd-ctl/backup.md.Checklist
npx hugo --quiet)