Slate1 Spring Rest Docs를 Markdown으로 작성하기 이번에 새로 시작하는 프로젝트에 Spring Rest Docs를 적용해보기로 했습니다. Spring Rest Docs를 처음 들어보시는 분들을 위해 간단하게 소개하자면, 테스트 코드를 기반으로 문서를 자동으로 생성해주는 프로젝트입니다. 팀의 API 문서 자동화를 위해 선택하게 되었는데요, Swagger가 가지고 있는 단점들을 충분히 커버해줄만하다는 생각에 선택하게 되었습니다. Spring Boot Rest Docs의 기본 조합인 Mock MVC & Asciidoc 을 사용하지 않고, Spock & Rest Assured & Markdown을 써야겠다고 생각했는데요. 이미 Groovy & Spock 기반으로 동적 언어로 테스트 코드 작성이 익숙한 상태 문서화를 위해 테스트 프레임워크를 변경하는건 배보다 배.. 2018. 4. 26. 이전 1 다음