🔗 OpenAPI DSLs: The silent developer productivity killer

I learned that relying on Domain-Specific Languages (DSLs) for OpenAPI documentation can lead to significant productivity pitfalls. In a recent experience with Elixir, I faced a convoluted mess when trying to manage my API specs embedded within controller logic. The DSL library imposed rigid structures, causing unnecessary complexity and confusion. The result? I had to switch back to a straightforward YAML specification, which not only simplified the process but also reduced errors when interacting with AI tools like ChatGPT. Without the added abstraction, the YAML format was easier to read, and it became apparent that the claimed benefits of the DSL didn't outweigh its drawbacks. In the end, simpler often means better.