Lexis 다이어그램이라고 들어보셨나요?
가로에 시간(이벤트) 세로축에 나이를 표시해 서로 다른 나이(코호트, 동일 집단)의 인물들이 어떻게 동일 사건을 경험하는지 비교하는 그래프입니다.
요즘 저주받은 세대라고 하면서 나이별로 어떤 사회적 어려움을 겪었는지 나열하는 기사들을 봤는데요. 또 어떤 특정 시기에 유행했던 문화를 아는지 모르는지로 세대를 구분하는 인터넷 밈들이 있었는데요. 같은 시대를 함께 살아도 연령대에 따라 영향이 다를 수 밖에 없습니다. 어떤 해에 유행하던 노래를 초등학교때 들었는지 학교를 졸업하고 사회 생활하면서 들었는지에 따라 기억하는 감성이 다른 경우가 있더라구요. lexis 다이어그램을 이용하면 이런 서사적인 정보를 시각적으로 표현하는데 유용합니다.
< 💡 Spring Rest Docs 로 Swagger API 문서 관리 자동화 >
💬 Spring Rest Docs 란?
Spring REST Docs 는 RESTful 서비스의 문서화를 도와주는 도구이다.
문서 작성 도구로 Asciidoctor 를 기본적으로 사용하며, 이것을 통해 HTML 문서를 생성한다. 필요한 경우 Markdown 문법을 사용하도록 변경할 수 있다.
RESTful API를 문서화 할때 중요한 포인트는 API 에서 필요한 HTTP 요청과 응답의 리소스를 설명하는 것인데 Spring REST Docs 를 사용할 경우 테스트 코드를 작성하여 이러한 리소스와 HTTP 요청/응답에 대한 세부 내용을 문서화하는데 편리한 기능을 제공한다.
💬 Swagger 란?
RESTful API 를 약속된 규칙에 따라 json 이나 yaml 형식으로 문서화한 Open API Specification(OAS) 라는게 있는데 이 문서를 관리하기위한 목적으로 만들어진 프레임워크다.
API 문서 자동화 도구로 Spring REST Docs 의 비교군으로 자주 등장하는데 Spring 을 사용할 경우 서비스 코드에 어노테이션... 더 보기