docs: Improve archive log docs as to why it's not recommended

[Joibel]

And document how to make life easier with links.

Switch to an admonition as per #12561.

Header:

And then new documentation

Verification

mkdocs build

See screenshots above.

[agilgur5]

I'm guessing this is a follow-up to the question and my answer in #12593?

I haven't gotten that question too often, but good to have a longer note on it. In particular Argo seems to get a good bit of users who aren't necessarily operators/k8s cluster-admins and so may not know about fluentd, Splunk, ELK etc.

[agilgur5]

Recommending some structural changes for more directness and changing the verbal descriptions of links to example YAML. Also some changes per the style guide

[Joibel]

I'm guessing this is a follow-up to the question and my answer in #12593?

I haven't gotten that question too often, but good to have a longer note on it. In particular Argo seems to get a good bit of users who aren't necessarily operators/k8s cluster-admins and so may not know about fluentd, Splunk, ELK etc.

Yes, directly inspired by that. It's a common question in face-to-face chats with argo users, so I thought worth addressing with a long term fix.

[Joibel]

Screenshots at the top of the issue are updated with the latest changes.

[Joibel]

@agilgur5 could you check you're happy with this?

[agilgur5]

This is better, but there are still some pieces from the old version remaining that are now quite repetitive (and themselves still have style issues). Re-ordering it as suggested below will consolidate that significantly

[ljyanesm]

Is there a way to reconfigure the UI after having followed these new recommendations to disable the default logs button and possibly the other warnings and references to logs?

Seems a bit awkward to potentially have multiple buttons for logs where some of them won't resolve but would still be enabled.

[Joibel]

Screenshot updated at the top.

[agilgur5]

Screenshot updated at the top.

This needs updating once more, but otherwise LGTM. EDIT: I updated it myself now that I have that permission

[agilgur5]

LGTM; addresses a common question