Earlier quoted context omitted.
Polkit is a nightmare . And I agree with you on the churn. There was a time when Linux administration changed less frequently than Windows, round about the 95-XP-Vista era.
http://smcv.pseudorandom.co.uk/2015/why_polkit/
* Like pretty much anything from freedesktop.org, the documentation is a joke.
* The security system implemented through it is next to impossible to debug. It's very easy to add "allow to happen", but I can't do things like "ok, tell me who can mount filesystems" or "give me a list of all things that users in the wheel group are allowed to do". Normally this would be trivial to implement by parsing the rule files, except that the rules are written in JS (I have no idea why) and parsed in a particular, cumbersome order.
* Probably also as an artifact of having to execute JS code to add rules, many errors are silent, incomprehensible, or occur only when a particular action happens.
* polkit doesn't have a textual interface, it only works through D-Bus. This makes it useless for scripting.