MSA 프로젝트를 진행하다가 API 문서에 대해서 팀원분이 Swagger를 쓰겠다고 했을때, 저는 안되는 이유에 대해서 설명을 해드렸습니다. " 서비스가 쪼개질때마다 swagger 문서가 production에 생길텐데, 프론트 앤드 엔지니어 입장이라면 원하는 API문서를 찾을때까지 뒤지는건 생산성이 떨어진다." 그러면서 API문서 구축하시는 분께 다른 방법이 있는지 찾아달라고 부탁드렸습니다. (정 없다면 스프레드 시트로 작성해야죠.....!!) 아니다 다를까 MSA가 화두되고 있는 지금 다른 방법이 아예 없지는 않았습니다. 팀원분이 하루만에 방법을 찾아오셨더라고요 해당 방법은 아래와 같았습니다. 서비스별 Rest Docs을 생성한다. 생성된 Rest Doc을 Open API 형태의 Json 포맷으로 만다..
