@ryan-pfizer, thanks very much for the clear and actionable feedback.

@open-telemetry/docs-approvers, it looks like the K8s demo is documented in two places. Perhaps we should keep the content in one section and just link to it from the other?

@tiffany76 this seems like a good use case for a shortcode I think. I still think it's valuable to have the demo chart node under the k8s docs separate from the demo docs, though.

@ryan-pfizer, would you like to submit a PR to add the helm repo add command where it's missing?

We can work on adding a shortcode later.

It might be better to consider refactoring the docs a bit (if necessary), and have a canonical "install" page or section that can be linked into? I agree with @tiffany76 that this issue can be used to get a fix in and we can have another to track possible rework (that may or may not involve a shortcode).