React 공식 문서 런칭
2023년 3월 16일 오랫동안 베타에 머물러 있던 공식 문서가 정식으로 런칭되었다. 새로운 리액트 공식 문서는 함수 컴포넌트와 훅을 중심으로 새롭게 쓰였으며 다이어그램, 삽화, 챌린지 그리고 수많은 예제를 포함한다.
공식 문서 함께 읽기 스터디 주최
항상 리액트를 제대로 쓰고 있는지 의구심이 있던 차에 소식을 듣고 공식 문서를 혼자 읽어보려 했다. 그러나 초반부인 Describing the UI까지 읽다가 이런저런 핑계로 미루게 되고 만다.
결국 목마른 사람이 우물을 판다고 지난번에 주최했던 리팩터링 2판 스터디의 경험을 토대로 모여서 문서를 각자 읽고 토의하는 React 공식 문서 읽기 스터디를 모집하게 되었다.
이번이 두 번째로 주최하는 스터디인데 지난 스터디보다는 조금 더 개선되고 유익한 스터디를 꾸려봐야지 하는 마음으로 5월 초에 시작해 현재 1/3가량 진행 중이다.
웹 문서 토의의 어려움
이 스터디는 한 사람이 화면을 띄워두고 읽어나가는 것이 아니라 각자 속도에 맞게 읽고 정해둔 독서 시간이 끝나면 중요하게 생각했던 부분을 공유하며 토의하는 방식으로 진행된다. 그런데 책으로 하는 스터디와 달리 몇 가지 난관에 부딪히게 되었는데 무엇보다도 문장의 위치를 공유하기가 쉽지 않았다.
책의 경우 각자 밑줄 친 부분을 공유할 때 몇 쪽 > 몇 번째 문단 > 몇 번째 줄인지 차례대로 이야기하면 위치를 찾기 어렵지 않았던 반면, 웹 문서의 경우 스크롤로 이어지기 때문에 위치를 지정하기가 애매해지며 헤딩(h1, h2, ...)을 알려준다 해도 목차(TOC)가 없는 이상 해당 지점으로 바로 이동할 수 없어 헤매게 된다.
첫날 발표를 맡았을 때 미처 생각지 못한 위기에 허둥지둥하며 다소 산만한 화면을 공유하게 되었다. 이러다 스터디 망할지도(?) 라는 위기감을 느끼고 방법을 고민하다가 웹 사이트에 하이라이트를 해보자 하는 생각이 들어 서비스를 찾기 시작했다.
Hypothesis: 하이라이트 툴
요구 사항은 1) 화면에 하이라이트를 할 수 있을 것 2) 가능하면 실시간으로 하이라이트를 공유할 수 있을 것 이렇게 두 가지였다.
몇몇 서비스가 있었지만 Hypothesis라는 서비스에 눈길이 갔는데 우선 필요로 하는 기능이 모두 있는 데다 핵심 기능 몇 가지에 집중하고 있었고 교육 분야에서 많이 쓰이는 것으로 보여 스터디에 적합하다는 생각이 들었다. 이건 개인적인 의견이지만 디자인이 유려하지 않은데 오히려 그런 허름함이 숨겨진 맛집을 찾은 것 같아 더 믿음이 갔다.
가입 후 익스텐션을 설치하기만 하면 무료로 이용할 수 있다는 점이 가벼운 마음으로 테스트할 수 있는 환경을 제공했다. 특히 오픈 소스이고 비영리 조직에서 운영하기 때문에 광고나 유료 결제를 과하게 유도하지 않을 것 같았고 스터디원들에게 권유하기에 부담이 없었다.
시범 삼아 도입해보니 스터디 경험이 개선되어 반응이 좋았고👍 이후 스터디에서 적극적으로 활용하려 한다. 아래 이미지는 스터디에서 팀원들과 하이라이트를 하며 문서를 읽어나간 모습인데 우측을 보면 각자 하이라이트하고 주석을 남겨 둔 과정을 확인할 수 있다. 서로 읽는 속도가 다르기 때문에 다른 사람이 남긴 하이라이트에 댓글을 달기도 한다.
각 카드는 위치 순으로 정렬되며 카드를 클릭하면 해당 하이라이트를 남긴 위치로 스크롤이 이동되기 때문에 매끄럽게 화면을 이동하며 발표를 진행할 수 있다. 또한 각자의 의견이 이미 웹상에 작성되어 있기 때문에 기록을 맡은 팀원도 추가적인 의견만 받아쓰고 토의에 더 집중할 수 있다는 점이 큰 장점이라고 본다.
다만 한 가지 주의할 점은 URL 단위로 하이라이트가 통합되어 보이기 때문에 반드시 같은 사이트에서 진행해야 한다는 것이다. 당연히 같은 사이트에서 진행하지 않냐고 생각할 수 있지만 현재 리액트 문서의 번역이 다 끝나지 않은 상태이고 선호하는 언어가 다른 경우 각자 다른 사이트에서 보게 될 수도 있다. 예를 들어, 공식 문서(영어), 공식 문서(한국어), 비공식 문서(영어와 한국어 병기) 이렇게 3가지에 하이라이트가 나눠지는 난감한 경우가 발생할 수 있다.
참고자료
유사한 스터디를 진행 중이거나 진행할 예정인 분들에게 적극 추천합니다. 실시간으로 공유되는 하이라이트를 통해 일방적인 전달이 아닌 서로의 경험과 다양한 시각을 나누며 깊어지는 스터디를 즐겨보세요!
