Skip to content

ci: feature-agnostic conventions for stating a version or edition con… - #7789

Merged
jstirnaman merged 3 commits into
masterfrom
jts-version-avail
Sep 18, 2026
Merged

jstirnaman merged 3 commits into
masterfrom
jts-version-avail

Conversation

@jstirnaman

Copy link
Copy Markdown
Contributor

No description provided.

…straint: which marker to use for page-wide versus section-level scope, which surface carries which fact, where a page lives when a feature spans two products, the version-check pattern, and how temporary notices are retired.
@github-actions

Copy link
Copy Markdown
Contributor

Vale Style Check Results

Metric Count
Errors 0
Warnings 0

Check passed

…page

What changed:
- Rewrite the "Include a version check" section of DOCS-VERSION-AVAILABILITY.md
  to state the rule and link to content/shared/identify-version.md instead of
  restating InfluxDB 3 CLI and /ping commands.
- Scope the remaining /ping guidance explicitly to InfluxDB 3 Core and
  Enterprise.
- Move the "HEAD returns 404" fact into content/shared/identify-version.md,
  beside both InfluxDB 3 /ping examples.

Why:
The section showed only InfluxDB 3 commands without saying so. A writer
working on v1, v2, Clustered, or Cloud content would have followed it and
documented the wrong CLI, port, and endpoint. The commands already live in one
shared source that covers every product, so duplicating them here created a
second place to drift.

Impact:
Contributor guidance only, plus one sentence added to the 11 pages that
consume the shared file. No commands or behavior change.

Verification:
- yarn verify:changed on both paths.
- yarn lint-codeblocks content/shared/identify-version.md passes.
- HEAD/404 confirmed against api-docs/_build/influxdb3/core/influxdb3-core-openapi.yaml,
  where /ping defines only get and post.
@jstirnaman
jstirnaman marked this pull request as ready for review September 18, 2026 15:54
@jstirnaman
jstirnaman requested a review from a team as a code owner September 18, 2026 15:54
@jstirnaman
jstirnaman requested review from sanderson and removed request for a team September 18, 2026 15:54
@github-actions

github-actions Bot commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Check Results — Link Check Bot

All links are valid

Metric Value
Files Checked 11
Total Links 4146
Errors 0
Warnings 11
Success Rate 99.20405%
⚠️ 11 warning(s) (do not fail CI)
Source File URL Issue
content/enterprise_influxdb/v1/administration/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb/cloud/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb/v1/administration/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb/v2/admin/identify-version/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb3/cloud-dedicated/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/cloud-serverless/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/cloud/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/clustered/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/core/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/enterprise/admin/identify-version/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/platform/identify-version/_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-09-18 16:07:25 UTC

@github-actions github-actions Bot added product:shared Shared content across products product:v1 InfluxDB v1 OSS product:v1-enterprise InfluxDB Enterprise v1 product:v2 InfluxDB v2 (Cloud TSM, OSS) product:v2-cloud InfluxDB Cloud (TSM) product:v3-distributed InfluxDB 3 Cloud Serverless, Cloud Dedicated, Clustered product:v3-monolith InfluxDB 3 Core and Enterprise (single-node / clusterable) labels Sep 18, 2026
@jstirnaman
jstirnaman merged commit a4d9198 into master Sep 18, 2026
24 checks passed
@jstirnaman
jstirnaman deleted the jts-version-avail branch September 18, 2026 16:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:shared Shared content across products product:v1-enterprise InfluxDB Enterprise v1 product:v1 InfluxDB v1 OSS product:v2-cloud InfluxDB Cloud (TSM) product:v2 InfluxDB v2 (Cloud TSM, OSS) product:v3-distributed InfluxDB 3 Cloud Serverless, Cloud Dedicated, Clustered product:v3-monolith InfluxDB 3 Core and Enterprise (single-node / clusterable)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant