3 ms·

Anything that stands between the programmer and the code is doomed to be abused by those who can't. The whole concept of specifying an API in a DSL should be l

Anything that stands between the programmer and the code is doomed to be abused by those who can't. The whole concept of specifying an API in a DSL should be limited to the domain and not be standardised. OTOH, I am all for literate programming that combines the art of writing prose and code like in Jupiter Notebook. Among competitors to OpenAPI I keep an eye on API Blueprint. While it leans more towards prose than code, it is a valuable tool to document APIs.

BerislavLopac 5y ago
> Anything that stands between the programmer and the code is doomed to be abused by those who can't. Those who can't what? If you mean the ability to code, I don't understand how is that related to API specifications. > The whole concept of specifying an API in a DSL should be limited to the domain and not be standardised. Why exactly?