I think the backseat developers in this thread are missing a lot of context and are just making a ton of assumptions (as usual). For some context, maybe look at some of the other hundreds of automatically generated documentation files like these for some more understanding on what other things these files can contain and why they might have gone the way they did with the way they generate these.
You don't need to be a video game designer to have a certain level of logic. FF14 and ESO have maps decorated with....the same furniture used for player housing. How many furnitures we have in WoW that are worth being used in housing in WoW?. Most of them are 2004 decoration objects in Orgrimmar, Stormwin, Thunder Bluff, Undercity, etc, that have really outdated graphics and designs.
Also, If I remember right. MMO Champ used to make fun of me and others, who suggested housing in WoW, because ESO and FF14 had housing system. Now here we are...with a housing system for the next expansion, that to be honest, I have no idea how is going to work, if the few furniture items on WoW actually sucks a lot.
There's several kits that they could use, but doing Human/Orc themes first would be the easiest win given the pre-existing garrison kits that still largely hold up today so asset creation, at least for doodads, is largely taken care of for the first iteration of the system. Most of the other kits added in recent expansions aren't for core races outside of maybe the Earthen/Goblin kits in 11.x and the Dragon kit in 10.x for the Dracthyr. All of the other recent kits that I can think of are subcultures or non-player races.
If you're talking about the UI in general, it definitely has issues, especially since the DF rework. But going off your previous replies you were specifically talking about the file in the OP, and none of the UI issues the game has are related to how these hundreds of automatically generated documentation files are laid out, including the one from OP.
They're perfectly fine for the usecases they are built for, which is the interactive /api command as well as to help addon developers make stuff through loading these in IDE plugins or to check for changes between patches. These files don't run the game's UI or cause any of the issues you have mentioned. They're a simple service that Blizzard provides for addon devs. Shitting on specifically that is... an interesting choice out of all the things one could shit on.