이번 프로젝트에서는 API 문서를 자동화하고 공유하기 위해 Swagger와 Spring REST Docs를 모두 적용해봤다. 둘 다 장단점이 명확했지만, 결론적으로는 REST Docs를 중심으로 사용하게 되었다. 이 글에서는 두 방식의 차이와 실제 적용 후 느낀 점, 그리고 각각의 사용법을 간단히 정리한다. 두 방식의 차이 비교 항목 Spring REST Docs Swagger (Springdoc/OpenAPI) 문서 생성 방식테스트 기반 (MockMvc 등)코드 기반 애너테이션정확성실제 응답을 기반으로 생성됨애너테이션 기반 → 실제 응답과 다를 수 있음의존성Asciidoctor + restdocs 필요springdoc-openapi 또는 springfox목적배포용 정적 문서개발자 UI 테스트용..
