Improve Serving encryption docs

[ReToCode]

Addressing #5804 (comment)

[ReToCode]

/assign @rhuss

[netlify]

✅ Deploy Preview for knative ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	a7231cf
🔍 Latest deploy log	https://app.netlify.com/sites/knative/deploys/663874f3ad7ae20008db478d
😎 Deploy Preview	https://deploy-preview-5955--knative.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

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

[rhuss]

Thanks @ReToCode for adressing. Just a minor nit, but looks good to me and I think it makes it easier for peoples to understand.

You could also use something like callouts, which would render nicely in asciidoc, but could make sense, here, too. Maybe even our HTML rendering framework does support something like this ? 🤔

kind:ClusterIssuer    
metadata:
  name: cluster-selfsigned-user  # <1>
....
....
# <1>: Issuer used by cert-manager to ...
#      .... <next line>
# <2>: Knative specific issuer that will uses the CA stored
#      in the secret "<name>" which has been created by the
#      certificate "<name>"

But that's just some icing on the cake, so I approve it with a /hold. Feel free to adjust or merge.

/approve
/lgtm
/hold

[knative-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ReToCode, rhuss

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• docs/serving/OWNERS [ReToCode]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[ReToCode]

@rhuss I don't think it is supported with the config used here:

Checked with and without the #.

[ReToCode]

/unhold

@rhuss PTAL

[rhuss]

@ReToCode even it is not rendered a callouts, the comment syntax in #5955 (review) should stimm work as it is valid YAML commenting.

My issue was, that if you add a very long trailing comment at the end of line, it leads to horizontal scrolling in the rendered web pages which is always annoying. So I would at leat put the comment above the line and make it maybe a multi-line comment if it is too long.

As this is "just" a usability issue, its fine for me as mentioned (I still add a /hold so you might still be able to adapt this (or not :)

/hold
/lgtm

[ReToCode]

/unhold

Let's revisit this as a separate topic. If we do that, we should probably do it as a general pattern :)