Confusing info box in the Operator documentation

[jerrinot]

The Getting Started guide has this infobox:

I find the text confusing. When it can be inaccurate? Is it just "check-then-act"? What does "informational purposes" means exactly? What is the use-case where I can use this field and when I should NOT rely on it?

[SeriyBg]

@jerrinot the reason for this is that readyMembers are listening for the MembershipStateChangeds which are fire-and-forget events. Thus we do not recommend to thread it a reliable source of truth. But I agree that this can be described more thoroughly

[JakeSCahill]

How does this affect users?

In what circumstances would this value be inaccurate?

What more accurate ways do we offer to check how many active members are in the cluster?

[SeriyBg]

@JakeSCahill I don't think there is a precise scenario when this value is inaccurate. The more accurate data will be provided in the future with the implementation of advanced cluster status

[JakeSCahill]

So the potential for a user to see an inaccurate value there is negligible?

Maybe the best course of action is to remove the warning.