backend 개발자들이 API 문서화를 하는 방법에는 여러 가지 방법이 있다. 1. 수기를 통한 문서화 2. postman publish 기능을 통한 문서화 3. swagger를 활용한 문서화 4. Spring REST Docs를 활용한 문서화 ... 각각의 API 문서화마다 장단점이 있을 것이다. 특히 1번, 2번 방식은 별로 추천하지 않는 방식이다. [추천하지 않는 이유] api 명세가 바뀌었을 때 까먹고 바꿔주지 않는다면 api 명세 기능을 잃어버린다. 개발자가 실수로 오타를 내었을 때 누군가 알려주지 않는 이상 이를 발견하기 힘들다. Swagger와 Rest Docs 방식을 통한 API 문서화 방법 중 이번 장에서는 Spring Rest Docs를 활용한 API 문서화 방법을 알아보려고 한다. ..
