I find in this page, there are many tables to show the usage of parameters. I don't think using table is a preferred way. It is hard to read and unfriendly in mobile views.
For example:
| parameter | description | example |
|---|---|---|
| aliases | description of aliases | <syntaxhighlight>...</syntaxhighlight> |
The better way to present content may be:
=== aliases === description of aliases Example: <syntaxhighlight>...</syntaxhighlight>
TemplateData is stored in machine-readable JSON, and I think that JSON might create the tables.
The complaint is not about TemplateData, but about the wikitext page Help:TemplateData – to be exact, about Help:TemplateData#Template data parameters. (By the way, even if it was about TemplateData itself – JSON doesn’t create tables, it’s just a format for storing data. Those tables are created by PHP code that was programmed to create tables, but which could just as well be programmed to create definition lists or whatever format we want.)