Arazzo as the Next-Layer Specification for Workflow Intent Across APIs
Arazzo is an OpenAPI Initiative specification for describing API workflows: ordered sequences of calls, their dependencies, the inputs they require, the outp...
Arazzo is an OpenAPI Initiative specification for describing API workflows: ordered sequences of calls, their dependencies, the inputs they require, the outp...
We tend to treat a documented API as a usable API. If the endpoints are described, the parameters are typed, and the responses are listed, the hard part shou...
In the age of artificial intelligence, the temptation is to apply this technology to everything, guided by the mantra: “Got a problem? AI can solve it.” or w...
We have seen in the previous article that our primary driver is to keep the software documentation as near as possible to the developer, from a tool landscap...
This article will present how I envisage software documentation from the development, and tooling side. First of all, architecture documentation is a critica...
For a while, I found a list of articles from Nikolay Ashanin about software architect role and software architecture in general, and I encourage any software...