A lot of the problems related to organization of entities and type description can be solved by using out-of-band type metadata (i.e. GraphQL). It’s not a panacea by any means, and may not be the right fit for many APIs, but I’m surprised it wasn’t mentioned at all, considering that the article is about API design.