@book {2021:bapie, title = {Beautiful API Evolution}, year = {2021}, publisher = {LeanPub}, organization = {LeanPub}, abstract = {This book presents the catalog of a virtual exhibition featuring different visualizations of the structural evolution of 51 Web APIs of different sizes and shapes, showing how they mostly grow but sometimes also shed some dead branches over the years. The diagrams are drawn based on the exact OpenAPI specifications as they were versioned on some open source repository. While there are many books on how to improve the design of existing APIs, the goal of this book is to show a small sample of actual API designs undergoing change. Learn from these examples to avoid false starts and discover which structures turn out to be stable over the years. All APIs represented are Web APIs: they come from the age when many attempted with very different results to use the HTTP protocol to remotely invoke software delivered as a service. The APIs have been selected mainly due to their visual appearance.}, keywords = {API, API Evolution, visualization}, url = {https://leanpub.com/beautiful-api-evolution/}, author = {Cesare Pautasso} } @inproceedings {saw:2011:shark, title = {Goals, questions and metrics for architectural decision models}, year = {2011}, month = {May}, pages = {21{\textendash}28}, publisher = {ACM}, address = {Waikiki, Hawaii, USA}, abstract = {Architectural decisions are the key element behind the design process leading to a software architecture. Making software architects aware of the implications of their decisions is only the beginning of what can be achieved by capturing the rationale and the constraints influencing the decision making process in a reusable body of architectural knowledge. In this paper we propose a metric-based approach to the analysis of architectural decision models. Using a hierarchically-structured approach we identify a number of useful goals and stakeholders involved in the architectural design process. Next, we sketch a set of metrics to provide data for the evaluation of the aforementioned goals. Our aim is to stimulate a discussion on how to find indicators relevant for software architects by measuring the intrinsic properties of architectural knowledge.}, keywords = {architectural decision modeling, metrics, SAW, software architecture, visualization}, isbn = {978-1-4503-0596-9}, doi = {10.1145/1988676.1988682}, author = {Marcin Nowak and Cesare Pautasso} }