Merge pull request #4004 from replicatedhq/laverya/sc-136963/troubleshoot-crds-don-t-exist-on-helm-cli

document the recommended 'inside secret' method for supportbundle res…

Author: paigecalvert

docs/reference/linter.mdx

@@ -1123,6 +1123,26 @@ For more information, see [LintConfig](custom-resource-lintconfig).
   </tr>
 </table>
 
+### troubleshoot-spec-in-chart-without-crd
+
+<table>
+  <tr>
+    <th>Description</th>
+    <td>
+      <p>Notifies if a Helm chart contains a top-level <code>kind: Preflight</code> or <code>kind: SupportBundle</code> custom resource.</p>
+      <p>Preflight and SupportBundle custom resources cannot be applied directly from a Helm chart — they require cluster-side CRDs that are not available in most shared clusters and that need cluster-admin permissions to install. Embed the spec in a Kubernetes Secret with the <code>troubleshoot.sh/kind</code> label instead. See <a href="/vendor/preflight-defining">Define preflight checks</a> and <a href="/vendor/support-bundle-customizing">Add and customize support bundles</a>.</p>
+    </td>
+  </tr>
+  <tr>
+    <th>Level</th>
+    <td>Warn</td>
+  </tr>
+  <tr>
+    <th>Applies To</th>
+    <td>Helm chart archives in the release</td>
+  </tr>
+</table>
+
 ### volume-docker-sock
 
 <table>