Skip to content

Restructure status informers docs to lead with SDK#4093

Merged
AmberAlston merged 1 commit into
mainfrom
status-informers-lead-with-sdk
May 22, 2026
Merged

Restructure status informers docs to lead with SDK#4093
AmberAlston merged 1 commit into
mainfrom
status-informers-lead-with-sdk

Conversation

@AmberAlston
Copy link
Copy Markdown
Member

Summary

  • Restructures the "Enable application status insights" section to lead with the Replicated SDK as the recommended approach
  • Renames "Helm CLI installations" to "Configure status with the Replicated SDK (recommended)"
  • Renames "Replicated installers" to "Configure status with the Application custom resource (KOTS existing cluster only)"
  • Adds intro paragraph making it clear the SDK is the recommended path for all installation methods
  • Links to the Application CR reference page

Part of KOTS de-emphasis Phase 2 (epic 137934, story sc-137946).

Test plan

  • Verify page renders correctly at /vendor/insights-app-status
  • Confirm anchor links #helm-cli-installations and #replicated-installers still work (preserved for backwards compatibility)

🤖 Generated with Claude Code

- Rename sections to make SDK the recommended approach
- Clarify that SDK works for both Helm CLI and Replicated installer
  installations
- Relabel Application CR approach as KOTS existing cluster only
- Link to Application CR reference page

Part of KOTS de-emphasis Phase 2 (epic 137934, story sc-137946).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@AmberAlston AmberAlston requested a review from a team as a code owner May 22, 2026 19:20
@netlify
Copy link
Copy Markdown

netlify Bot commented May 22, 2026

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit b590ee2
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a10ac81a7b9b7000856f897
😎 Deploy Preview https://deploy-preview-4093--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 22, 2026

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit b590ee2
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a10ac814151610008fb7237
😎 Deploy Preview https://deploy-preview-4093--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels May 22, 2026
### Configure status with the Replicated SDK (recommended) {#helm-cli-installations}

For Helm CLI installations, you can include the Replicated SDK as a dependency in your primary Helm chart to get status data. When the application is deployed using `helm install` or `helm upgrade`, the SDK automatically detects and reports the status of resources in the Helm release for the given chart. You can also override the list of resources that get reported on using the SDK's [`statusInformers`](https://github.com/replicatedhq/replicated-sdk/blob/main/chart/values.yaml#L287) value.
When you include the Replicated SDK as a dependency in your primary Helm chart, the SDK automatically detects and reports the status of resources in the Helm release. You can also override the list of resources that get reported on using the SDK's [`statusInformers`](https://github.com/replicatedhq/replicated-sdk/blob/main/chart/values.yaml#L287) value.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.SentenceLength] Try to keep your sentence length to 26 words or fewer.


:::note
When Helm-based applications that include the Replicated SDK and are deployed by a Replicated installer, the SDK inherits the status informers configured in the Replicated Application custom resource. In this case, the SDK does _not_ automatically report the status of the resources that are part of the Helm release. This prevents discrepancies in the instance data in the vendor platform.
When Helm-based applications that include the Replicated SDK are deployed by a Replicated installer, the SDK inherits the status informers configured in the Application custom resource. In this case, the SDK does _not_ automatically report the status of the resources that are part of the Helm release. This prevents discrepancies in the instance data in the Vendor Portal.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('are deployed').

@AmberAlston AmberAlston merged commit db504df into main May 22, 2026
6 checks passed
@AmberAlston AmberAlston deleted the status-informers-lead-with-sdk branch May 22, 2026 19:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants