I think it would be good to add, to the Leader election section, the use-case about running several instance of the custom controller workload/pod (i.e., only one being 'active') in order to increase the High Availability characteristics of your operator's controller (so the operator deployer has higher control on how fast a "blocked" currently 'active' controller instance is being replaced by another running (but not yet 'active') instance.
Adding this HA related use-case to the one currently described (related to a Deployment upgrade where new and old pod instance are running in parallel) would better show where this leader election support from Operator SDK can be used.
I think it would be good to add, to the Leader election section, the use-case about running several instance of the custom controller workload/pod (i.e., only one being 'active') in order to increase the High Availability characteristics of your operator's controller (so the operator deployer has higher control on how fast a "blocked" currently 'active' controller instance is being replaced by another running (but not yet 'active') instance.
Adding this HA related use-case to the one currently described (related to a Deployment upgrade where new and old pod instance are running in parallel) would better show where this leader election support from Operator SDK can be used.