Microservices are interesting. Not Technically, as they increase complexity. But they enable something really powerful: continuity of means, continuity of res

Microservices are interesting. Not Technically, as they increase complexity. But they enable something really powerful: continuity of means, continuity of responsibility, that way a small team has full hand of developing AND operating a piece of a solution. Basically, organization tends to be quite efficient when dealing with small teams (about dozen people, pizza rule and everything), that way information flows easily, with point to point communication without the need of a coordinator. However, with such architecture, greater emphasis should be put on interfaces (aka APIs). A detailed contract must be written (or even set as a policy): * how long the API while remain stable? * how will it be deprecated? with a Vn and Vn-1 scheme? * how is it documented? * what are the limitations? (performance, call rates, etc)? If you don't believe me, just read "Military-Standard-498". We can say anything about military standards, but military organizations, as people specifying, ordering and operating complex systems for decades, they know a thing or two about managing complex systems. And interfaces have a good place in their documentation corpus with the IRS (Interface Requirements Specification) and IDD (Interface Design Description) documents. Keep in mind this MIL-STD is from 1994.