API 문서 툴: OpenAPI 3.0 (Swagger)

라이브러리 버전은 springdoc-openapi 2.5.0 을 사용하였습니다.

해당 기술을 선택한 이유는 다음과 같습니다.

Swagger 는 매우 간단한 Configuration만으로 명세를 공유하는 것이 가능합니다. 프로젝트 초기에 빠르게 기능 개발을 시작해야 하는 저희 팀 환경에 적합하다고 판단했습니다.
프론트엔드 크루 모두가 Swagger 를 가장 선호했고, 백엔드 크루들도 Swagger 의 장단점을 잘 인지하고 있었기에 굳이 RestDocs 를 비롯하여 다른 문서화 도구를 선택할 이유가 없었습니다.
비즈니스 로직에 문서화 로직이 침투하여 가독, 책임 분리를 해치는 문제점은 추상화 및 어노테이션 커스터마이징으로 극복할 수 있다고 판단하였습니다. 현재 적절한 추상화를 통해 비즈니스 로직으로부터 문서화 로직을 분리하였습니다.