D2: like Mermaid, but better. Syntax, installation, and practical usage tips
D2 is an open-source tool to design architectural layouts using a declarative syntax. It’s a textual format, which can also be stored under source control. Let’s see how it works, how you can install it, and some practical usage tips. Continue reading
Fitness Functions in Software Architecture: measuring things to ensure prosperity
Non-functional requirements matter, but we often forget to validate them. You can measure them by setting up Fitness Functions. Continue reading
Davide's Code and Architecture Notes - the Error Management Trio, and how it affects your software architecture
When designing a software system, we naturally focus more on the happy flow. But we should carefully plan to handle errors that fall into three categories: Validation, Transient, and Fatal. Continue reading
Davide's Code and Architecture Notes - Practical creation of C4 Model diagrams with Structurizr
The C4 Model is one of the most famous ways to describe software architectures. Let’s see some practical usage with Strucutrizr. Continue reading
Davide's Code and Architecture Notes - Web APIs vs REST APIs vs pseudo-REST APIs
When describing a web service, people often use the wrong terms. Are you really creating a REST API, or is it some sort of pseudo-REST? Continue reading