Great API documentation is essential to a good developer experience. But your documentation should be great for non-developers too. When software moved online, so did the documentation. Today, hosted ...

With Cadl, you can write a 500-line OpenAPI definition in 50 lines of code. It’s a logical way for architects and developers to construct and constrain APIs. There’s an advantage to Microsoft’s work ...