Comment by altern8

OpenAPI is great, there are a lot of tools to go from OpenAPI to UI, but you don't have a lot of control over the presentation.

For instance, you can specify that "first_name","last_name" and "email" are strings, but not that first/last name should be next to each other and email in its own row.

There are supersets of OpenAPI that can control the look and feel more. JSON Forms, for instance.

This is cool, too, though.