[ska]

> Unless I miss something, this looks like a solution to nonexistent problem?

The generalizable 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.

The less you know about the domain, the larger and more diverse the group and the bigger the effort, the more likely this is to be true.

Of course there are exceptions, but they are rare.

[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.