Confusing steps in internode TLS setup docs #65245
Labels
>docs
General docs changes
:Security/TLS
SSL/TLS, Certificates
Team:Docs
Meta label for docs team
Team:Security
Meta label for security team
In https://www.elastic.co/guide/en/elasticsearch/reference/current/configuring-tls.html we have:
It looks like this exact wording was introduced in #63334 when we copied some wording from one section to another, but it doesn't quite land right here.
Steps (b) and (c) are saying more or less the same thing with different words. That can confuse the reader because they assume (c) is asking them to do something additional, but they can't work out what it is.
I suspect (b) is intended to cover node certificates (from step 2) and (c) is intended to cover the HTTP certificate store (from step 3), but that's not clear. Perhaps the solution is to explicitly refer to those steps? Something like:
_I don't like using "typically" in (b), but going into more explanation is hard, and I'm trying to avoid making big changes, since I know @lockewritesdocs is working on an full overhaul of these instructions.
The text was updated successfully, but these errors were encountered: