Schwarz GD, Riehle D (2025)
Publication Type: Conference contribution
Publication year: 2025
Publisher: Association for Computing Machinery, Inc
Pages Range: 589-592
Conference Proceedings Title: 16th International Conference on Internetware, Internetware 2025 - Proceedings
Event location: Trondheim, NOR
ISBN: 9798400719264
Microservices are a popular software architectural style that decomposes a large application into smaller services. These microservices integrate at runtime to deliver business value to the users. With an increasing number of microservices, software projects become more difficult to manage. Specifically, maintaining consistent and up-to-date documentation becomes a challenge that can significantly affect the integration efforts in such projects. In this article, we present MSAdoc, an open source tool that helps to prevent documentation from going out-of-date quickly. The tool (1) enables decentralized documentation close to the source code of each microservice and those who have to document it, (2) aggregates documentation centrally across individual microservices to make the documentation accessible in one place and generate higher-order documentation, while (3) supporting technological heterogeneity by relying on the technology-agnostic JSON format. Using a tool like MSAdoc that implements several best practices, practitioners can accommodate the decentralized nature of microservice-based projects and alleviate the problem of maintaining central documentation that quickly becomes outdated.
APA:
Schwarz, G.-D., & Riehle, D. (2025). Documenting Microservice Integration with MSAdoc. In Hong Mei, Jian Lv, Zhi Jin, Xuandong Li, Thomas Zimmermann, Ge Li, Lei Bu, Xin Xia (Eds.), 16th International Conference on Internetware, Internetware 2025 - Proceedings (pp. 589-592). Trondheim, NOR: Association for Computing Machinery, Inc.
MLA:
Schwarz, Georg-Daniel, and Dirk Riehle. "Documenting Microservice Integration with MSAdoc." Proceedings of the 16th International Conference on Internetware, Internetware 2025, Trondheim, NOR Ed. Hong Mei, Jian Lv, Zhi Jin, Xuandong Li, Thomas Zimmermann, Ge Li, Lei Bu, Xin Xia, Association for Computing Machinery, Inc, 2025. 589-592.
BibTeX: Download