[WoodenChair]

> The general answer to this is that almost always if some group of people has spent a good chunk of effort but you don't "get it", you have missed something.

Sure, but that doesn't mean that the group of people has cogently explained their work for their target audience. In this case, the target audience would be developers, whom it seems from the comments are confused.

[ska]

That's true, but I think it's a different problem. It's not clear that a spec should be expected to contain all the context needed.