Before reporting an issue

[x] I have read and understood the above terms for submitting issues, and I understand that my issue may be closed without action if I do not follow them.

Area

operator

Describe the bug

In our docs, we explicitly do not say what Kubernetes primitive should be used for Keycloak deployment - either StatefulSet or Deployment. In some places, we even mention Deployment more, and then confusion happens in our community (same as: https://github.com/keycloak/keycloak/issues/39866)

Related to https://github.com/keycloak/keycloak/discussions/11763

Version

main

Regression

[ ] The issue is a regression

Expected behavior

Users are aware of using StatefulSet as the Kubernetes primitive for Keycloak

Actual behavior

Users use Kubernetes Deployment and then face issues.

How to Reproduce?

...

Anything else?

No response