website icon indicating copy to clipboard operation
website copied to clipboard

Majority of the doc pages are too focussed on the `linkerd inject` command

Open col opened this issue 6 years ago • 1 comments

I don’t like that most of the docs only refer to the linkerd inject command.

Example: https://linkerd.io/2/features/protocol-detection/

We use Helm for all our deployments so I don’t want to use linkerd inject. What I’d really like to see in the documentation is the actual change that’s required in the yaml file with a side not that it can also be done via linkerd inject.

I feel like you’d trying to hide the details in an attempt to make it easier for people. In reality anyone that’s working with these tools will still need to be able to read and understand a k8s .yaml file. Hiding these details actually just makes Linkerd harder to use and debug.

col avatar Sep 23 '19 01:09 col

Why is https://linkerd.io/2/tasks/adding-your-service/ insufficient? I'd hate to add both methods everywhere, so I'm wondering what the best solution is.

grampelberg avatar Sep 23 '19 15:09 grampelberg