I'd say the spec is fine. It's the implementations of it that's a mess.

Mostly when it comes to the different voltages they can be set to provide.

Here's a video I saw recently which explains all about USB-C 'PD' (Power Delivery): https://www.youtube.com/watch?v=iumAnPiQSj8