TIL_210818

1. Facts(사실, 객관)

- swagger 사용법 정리

- fastcampus 강의

2. Feelings(느낌, 주관)

- Swagger 사용법을 정리했습니다. 백엔드에서 작성한 REST API를 Swagger를 통해 자동문서화를 하여 프론트엔드에 제공한 경험이 있습니다. 의존성 추가만 해주면, 자동으로 API 문서를 만들어주는 편리함을 경험했습니다. 물론 Spring Doc를 통해 만드는 방법이 Spring Boot에 좀 더 친화적인 방법이라고 생각하지만 이번 기회에 Swagger를 좀 더 자세히 알 수 있었습니다. 직접 Editor로 명세 작성과 Codegen을 통한 간단한 코드 생성도 가능했습니다. 항상 공식문서를 보면 좀 더 상세하고 다채롭게 알아갑니다. 단순히 자동화를 넘어서서, 응답코드나 예외상황, 각 변수에대한 설명 등 자세하게 활용하면 좋겠습니다.

 

3. Findings (배운 점)

- Swagger 사용법 정리

https://escapefromcoding.tistory.com/359

 

 

4. Affirmation (자기 선언)

 나는 프로젝트 완성 후 좋은 문서화를 끊임없이 고민하는 사람이다