> Yes, it is true that someone could return something that's part of this
array, but the wrong one. However, given how brittle those kinds of specs
are, and the fact that this text is purely informative, I don't believe
that including it inline for that purpose has positive gain. There's a lot
to lose and little to gain.

Why is it brittle?