Skip to content

docs: Validate the remote.* component topics - #7097

Open
clayton-cornell wants to merge 17 commits into
mainfrom
docs/validate-update-remote
Open

clayton-cornell wants to merge 17 commits into
mainfrom
docs/validate-update-remote

Conversation

@clayton-cornell

@clayton-cornell clayton-cornell commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

This PR is a general cleanup of the remote.* topics.

This is preliminary work that needs to be done as part of an overall project to migrate Examples either to task topics or to scenarios. The foundation of the component doc needs to be in good shape before any other work is undertaken.

Validated against the component source code, looking at Blocks, Arguments, completeness, accuracy, etc. Most fixes are cosmetic (markdown formatting, removing extra spaces, aligning tables). Some fixes covered errors in the existing examples, errors in the debug section, and product name errors.

Added review_date metadata to all files that have been reviewed. This is something we should start using on all doc topics going forward once they are fully reviewed, and updated with subsequent reviews.

Note for reviewers.

  • I changed a line in the example in remote.kubernetes.secret to read username = convert.nonsensitive(remote.kubernetes.secret.credentials.data["username"]). Claude flagged the original line as redundant and suggested multiple variations. I picked this one as the most logical looking, but it needs to be validated.
  • I changed some default values in remote.vault that need a double check. Specifically for resource_url and service_account_file. This what they look like they should be in the source, but I can't tell if they were left out of the docs on purpose or not... or if I'm reading the source incorrectly.

@clayton-cornell
clayton-cornell requested a review from a team September 11, 2026 20:26
@clayton-cornell clayton-cornell added the type/docs Docs Squad label across all Grafana Labs repos label Sep 11, 2026
Comment thread docs/sources/reference/components/remote/remote.kubernetes.secret.md Outdated
Comment thread docs/sources/reference/components/remote/remote.s3.md Outdated
Comment thread docs/sources/reference/components/remote/remote.s3.md Outdated
Comment thread docs/sources/reference/components/remote/remote.vault.md Outdated
@github-actions

github-actions Bot commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

💻 Deploy preview available (docs: Validate the remote.* component topics):

@clayton-cornell clayton-cornell added the backport/v1.19 Backport to release/v1.19 label Sep 11, 2026
@clayton-cornell
clayton-cornell marked this pull request as draft September 12, 2026 02:07
@clayton-cornell
clayton-cornell marked this pull request as ready for review September 14, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/v1.19 Backport to release/v1.19 type/docs Docs Squad label across all Grafana Labs repos

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant