탄생의블로그

❖ 설명 문서 자동화를 위해 rest docs과 swagger를 함께 진행하였다. 설명이 조금 길긴 하지만 단계적으로 정리하여 이해하기 쉽도록 정리하였습니다. ● rest docs을 작성하고 swagger로 변환하는 과정이다. 1. restdocs-api-spec을 정의(test code 작성 및 문서설명) 2. OpenAPI3 spec으로 변환 RESTful API를 정의된 규칙에 맞게 API spec을 json이나 yaml로 표현하는 방식을 의미합니다. 3. OpenAPI3 spec 변환 문서를 swaggerUI에 적용 4. build 및 테스트 ❖ git url https://bitbucket.org/basic-setup/kotlin-restdoc-swagger/src/master/ ❖ 구현 1. ..