Skip to content

fix(influxdb3): repair broken link fragments#7550

Open
jstirnaman wants to merge 3 commits into
masterfrom
jts/fix-broken-link-fragments
Open

fix(influxdb3): repair broken link fragments#7550
jstirnaman wants to merge 3 commits into
masterfrom
jts/fix-broken-link-fragments

Conversation

@jstirnaman

Copy link
Copy Markdown
Contributor

Closes #

What changed

  • Cleans up link fragments in code-tabs and ToC

Why

  • Fragments appear as broken in link reports, no-op in pages, poor UX

Impact

Verification

  • Check for inbound links to code-tab fragments. Keep targeted fragments.

Checklist

@jstirnaman
jstirnaman requested a review from a team as a code owner July 21, 2026 22:14
@jstirnaman
jstirnaman requested review from sanderson and removed request for a team July 21, 2026 22:14
@github-actions

Copy link
Copy Markdown
Contributor

Vale Style Check Results

Metric Count
Errors 0
Warnings 21
Warnings (21)
File Line Rule Message
content/influxdb3/core/admin/tokens/_index.md 9 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/create.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/create.md 5 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/create.md 25 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/list.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/list.md 26 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/regenerate.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/regenerate.md 5 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/core/admin/tokens/admin/regenerate.md 26 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/_index.md 11 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/create.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/create.md 5 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/create.md 6 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/create.md 27 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/list.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/list.md 26 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/regenerate.md 2 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/regenerate.md 6 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/regenerate.md 7 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.
content/influxdb3/enterprise/admin/tokens/admin/regenerate.md 25 InfluxDataDocs.WordList Use 'administrator' instead of 'admin'.

Showing first 20 of 21 warnings.


Check passed

@github-actions github-actions Bot added product:shared Shared content across products product:v3-distributed InfluxDB 3 Cloud Serverless, Cloud Dedicated, Clustered product:v3-monolith InfluxDB 3 Core and Enterprise (single-node / clusterable) labels Jul 21, 2026
@github-actions

github-actions Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Check Results — Link Check Bot

All links are valid

Metric Value
Files Checked 16
Total Links 6604
Errors 0
Warnings 47
Success Rate 98.80375%
⚠️ 47 warning(s) (do not fail CI)
Source File URL Issue
content/influxdb3/cloud-dedicated/reference/sample-data/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb3/cloud-dedicated/write-data/http-api/v3-wri… File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb3/cloud-dedicated/write-data/client-librarie… File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-dedicated/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/cloud-dedicated/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/cloud-serverless/reference/sample-data/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/influxdb3/cloud-serverless/reference/sample-data/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb3/cloud-serverless/admin/tokens/database File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/clustered/reference/sample-data/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb3/clustered/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/clustered/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/clustered/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/clustered/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …
content/influxdb3/clustered/write-data/http-api/compatibility-apis/_index.md file:///home/runner/work/docs-v2/docs-v2/public/influxdb/clustered/admin/tokens File not found. Check if file exists and path is correct: File not found. Check …

Showing first 20 of 47 warnings. See the workflow run for full results.


Full details: workflow run summary and artifact. Last updated: 2026-07-22 23:30:53 UTC

@github-actions

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://influxdata.github.io/docs-v2/pr-preview/pr-7550/

Built to branch gh-pages at 2026-07-21 22:17 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

your InfluxDB Cloud Dedicated database
- {{% code-placeholder-key %}}`DATABASE_TOKEN`{{% /code-placeholder-key %}}:
a [database token](/influxdb3/version/admin/tokens/#database-tokens)
a [database token](/influxdb3/version/admin/tokens/)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need a database or resource token path replacement here?

@jstirnaman

Copy link
Copy Markdown
Contributor Author

Additionally:

Results from searching /content/**/*.md:

Removed code-tab fragments in PR #7550 (for example #cli-filter-in-query, #http-api-filter-in-query, #cli-query-tokens, #cli-regenerate, etc.):
0 links found targeting those fragments.

Also removed in PR #7550: #javascriptnodejs
3 links still target it:

/home/runner/work/docs-v2/docs-v2/content/influxdb3/cloud-serverless/write-data/http-api/v1-http.md:239
/home/runner/work/docs-v2/docs-v2/content/influxdb3/clustered/guides/api-compatibility/v1/_index.md:376
/home/runner/work/docs-v2/docs-v2/content/influxdb3/cloud-dedicated/guides/api-compatibility/v1/_index.md:391
Also changed in PR #7550: #database-tokens removed in some links
There are still many links in /content targeting #database-tokens (dozens of files).

So: for the tab-fragment removals, I found no remaining targets; for #javascriptnodejs and #database-tokens, there are still links in content that may need follow-up.

@jstirnaman
jstirnaman marked this pull request as draft July 21, 2026 22:44
@jstirnaman
jstirnaman requested review from Copilot and removed request for sanderson July 21, 2026 22:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Repairs invalid link fragments in InfluxDB 3 documentation.

Changes:

  • Removes fragments from tab controls and token links.
  • Corrects the JavaScript client-library anchor.
  • Updates Cloud Serverless token terminology.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
content/shared/influxdb3-write-guides/http-api/compatibility-apis.md Corrects the JavaScript anchor.
content/shared/influxdb3-sample-data/sample-data-dist.md Removes invalid token fragments.
content/shared/influxdb3-admin/tokens/admin/regenerate.md Removes tab fragments.
content/shared/influxdb3-admin/tokens/admin/list.md Removes code-tab fragments.
content/shared/influxdb3-admin/tokens/admin/create.md Removes tab fragments.
content/shared/influxdb3-admin/tokens/_index.md Removes authentication-tab fragments.
content/influxdb3/enterprise/admin/tokens/resource/list.md Removes resource-token code-tab fragments.
content/influxdb3/cloud-serverless/reference/sample-data.md Corrects token links and terminology.

Comment on lines +259 to 260
an [API token](/influxdb3/cloud-serverless/admin/tokens/)
with _write_ permission to the database

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@claude Transclude database<->bucket and API_TOKEN<->DATABASE_TOKEN (see #7550 (comment)) so we can use the shared content page? Or keep separate pages and flag/replace edition misnomers?

Comment on lines 406 to 407
an [API token](/influxdb3/cloud-serverless/admin/tokens/)
with sufficient permissions to the specified database
@@ -180,7 +180,7 @@ Replace the following in the sample script:
- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
your InfluxDB Cloud Dedicated database

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@claude 1. replace all "your InfluxDB Cloud Dedicated database" in this file with your {{% product-name %}} database. 2. replace [database token](/influxdb3/version/admin/tokens/) with [database token](/influxdb3/version/admin/tokens/database/), which works with Clustered and Cloud Dedicated. 3. The Cloud Serverless page, /influxdb3/cloud-serverless/reference/sample-data/, also uses [database token](/influxdb3/version/admin/tokens/database/), but that's not an official Cloud Serverless concept - however, we should make it an informal concept by extending Cloud Serverless' Manage Tokens -> Custom Tokens--add a page that parallels the other InfluxDB 3 editions and gives opinionated instructions for creating a custom "database" token (and includes the standard note about bucket=database in Cloud Serverless)

Comment thread content/influxdb3/cloud-serverless/reference/sample-data.md Outdated
Use "database token" to be consistent with other editions. We can define it as a configuration variant of "API token".
@jstirnaman
jstirnaman marked this pull request as ready for review July 22, 2026 23:29
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: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.

3 participants