Spring docs
- 스프링 프레임 워크에서 제공하는 api 문서 자동화 도구
- 테스트 기반으로 문서화가 동작하기에 문서의 정확성을 보장하는데 도움이 된다.
- 문서화를 위한 코드가 테스트 코드에 존재하기에 프로덕션 코드에 영향을 주지 않는다는 장점도 존재한다.
Swagger
- api를 문서화 하고 테스트 할 수 있는 도구
- 테스트를 기반으로 문서화를 진행하는 Spring REST Docs와 달리 어노테이션을 통해 간편하게 API 문서를 자동으로 만들 수 있다.
- 자체적으로 사용자 친화적인 UI도 제공해주고 있기 때문에 문서를 쉽게 읽고 테스트할 수 있다.
참고 자료 : https://woo-chang.tistory.com/80