tosspayments-restdocs: 선언형 문서 작성 라이브러리

본 글은 Spring REST Docs의 장황한 코드와 반복적인 명세로 인한 가독성 및 생산성 저하 문제를 해결하기 위해 개발된 'tosspayments-restdocs' 라이브러리를 소개합니다. 이 라이브러리는 Kotlin DSL을 활용하여 최소한의 코드로 API 문서를 작성할 수 있게 하며, 코드 중복을 줄이고 세부 구현 및 의존성을 은닉하여 유지보수성을 높입니다.

또한, 변화에 유연하게 대처할 수 있도록 설계되었습니다. tosspayments-restdocs는 기존 Spring REST Docs 코드 대비 문서화 코드 양을 크게 줄여 개발자의 편의성을 향상시키는 것을 목표로 합니다.