본문으로 건너뛰기

도큐사우루스 2020 요약

· 약 13분
세바스티앵 로버(Sébastien Lorber)

도큐사우루스의 2020년은 엄청난 한 해였습니다. 물론 슬픈 소식을 전하며 시작했고 우리 모두에게 격동의 한 해였지만 말이죠.

우리는 도큐사우루스 2에 계속해서 투자해왔고 도큐사우루스 1에서 지원하는 대부분의 기능 호환성을 지원할 수 있습니다.

이제는 새로운 도큐사우루스 프로젝트를 시작한다면 기본 선택으로 도큐사우루스 2를 추천합니다. 그리고 v1 사용자들은 도큐사우루스 2로 이전할 것을 권장합니다.

아직 여전히 알파 버전이지만 조만간 좋은 소식을 전해드릴겁니다!

탁자 위에 나란히 놓인 3개의 도큐사우루스 인형

도큐사우루스 2에서 이런 걸 했습니다​

우리는 올해 많은 기능을 작업했습니다. 그 중 중요한 몇몇을 정리해보고자 합니다.

  • i18n: 여러분의 도큐사우루스 사이트를 쉽게 번역할 수 있습니다. 이제 곧 공개합니다! (미리보기, 가이드 문서)
  • 버전 목록: 상황에 따라 버전을 전환할 수 있습니다.
  • 버전 관리 옵션: 버전 관리 사용 시 자주 겪는 문제점을 해결했습니다.
  • 상황에 따른 검색: 새로 업그레이드된 DocSearch 3을 사용해 현재 버전 문서를 검색합니다.
  • 마크다운 페이지: 단일 페이지를 만들 때 리액트 컴포넌트 대신 마크다운을 사용합니다.
  • 테마 개선: UI, UX, 접근성 관련 여러 기능을 개선했습니다.
  • PWA: 오프라인에서 사이트를 설치해 사용할 수 있습니다.
  • 빠른 실패: 엄격한 설정 유효성 체크, 끊어진 링크 탐지 등을 통해 잘못된 제품이 배포되는 것을 방지합니다.
  • 멀티 인스턴스: 하나의 사이트에서 문서 플러그인을 두 번 사용할 수 있습니다(예. iOS/Android SDK 문서)
  • 마이그레이션 CLI: 도큐사우루스 1에서 자동으로 업그레이드합니다.
  • 코드샌드박스: 여러분의 브라우저에서 new.docusaurus.io에 접속해 도큐사우루스의 기능을 바로 확인해볼 수 있습니다.
  • 카나리(Canary) 릴리스: @canary npm 태그를 사용하면 좀 더 일찍 새로운 릴리스를 사용할 수 있습니다.
  • 타입스크립트: 내부 코드에 점진적으로 적용하고 사용자 기능으로 확장할 예정입니다.
  • 인피마(Infima) 공개: 이제 오픈 소스가 됐습니다.

도큐사우루스 2가 이렇게 성장하고 있습니다​

The plan to 2019년에 바닥부터 도큐사우루스를 다시 만들자는 계획은 어느 정도 성과를 거두었습니다. 천천히 진행하고 있지만 도큐사우루스 2는 여러 곳에서 사용하고 있으며 이제는 도큐사우루스 1보다 더 많은 곳에서 사용하고 있습니다.

2020년 도큐사우루스 v1, v2의 npm 트렌드. 도큐사우루스 v2의 설치는 눈에 띄게 증가하고 있는 반면 v1은 약간 하향세입니다. v1 설치는 15000에서 시작해서 10000으로 줄어들었지만 v2는 2000에서 시작해서 25000까지 늘어났습니다. 2020년 6월부터 두 버전 사이 역전이 발생했습니다.

주목할만한 프로젝트, 스타트업, 주요 기업, 개인이 도큐사우루스 2를 선택하고 있습니다(쇼케이스):

We helped 규모가 큰 도큐사우루스 1 사이트를 업그레이드하는 것도 지원하고 있습니다. 적절한 마이그레이션 가이드와 기능 호환성을 지원합니다.

리액트 네이티브 역시 성공적으로 도큐사우루스 2로 업그레이드했습니다(v1 사이트를 같이 확인해보세요):

도큐사우루스 v2로 구축된 React Native의 새로운 웹사이트

다국어를 지원하는 도큐사우루스 1 사이트(Jest 같은)도 업그레이드할 수 있습니다.

도큐사우루스 v2로 구축된 Jest의 새로운 일본어 웹사이트

또한 **첫 번째 RTL 지원 사이트**도 도큐사우루스 2를 사용해 공개됐습니다.

RTL 언어인 페르시아어로 작성된 Datagit의 웹사이트 사이드바는 창의 오른쪽에 표시되고 목차는 왼쪽에 나타납니다.

깃헙 활동​

  • Stars: 14632 → 20946 (전년대비 +43.2%)
  • 전체 기여자: 303 → 512 (전년대비 +68.9%). 대부분은 페이스북 소속이 아닌 기여자입니다.
  • 주간 npm 내려받기: 2356 → 25592 (전년대비 +986%)
  • 깃헙에서 도큐사우루스 1은 6311개 프로젝트에서 사용했으며(전년대비 +62.9%) 도큐사우루스 2는 5039개 프로젝트에서 사용했습니다(전년대비 +1940%)

메이저 리그 해킹 기여자와 협업​

우리는 이미 두 시즌동안 메이저 리그 해킹 (MLH) 기여자들과 함께 하고 있습니다.

아래와 같은 다양한 형태의 기여에 항상 감사하고 있습니다.

  • v1에서 v2로 이전하기 위한 마이그레이션 CLI 기반 작업
  • 리액트 네이티브 웹 사이트를 v1에서 v2로 이전하는데 기여
  • 구성 유효성 체크를 좀 더 엄격하고 철저하게 만들고 유용한 에러 메시지를 반환하도록 작업
  • 코드샌드박스 지원 추가
  • CI 파이프라인 개선: 빌드 크기, 라이트하우스 봇

2021년에도 협업이 계속 이어지기를 기대합니다.

미디어​

Dmitry Vinnik(개발자 애드보케이트 @ Facebook)는 도큐사우루스에 대한 60초와 15분 분량의 비디오를 공개했습니다.

Rachel Nabors(문서화 엔지니어 @ Facebook)는 React Native Radio 178 (팟캐스트)에서 도큐사우루스에 대한 언급을 했으며 William Candillon은 리액트 네이티브 웹 사이트 마이그레이션React Native website migration (비디오)를 공개했습니다.

여러 블로그 포스트에서도 도큐사우루스를 다루어주었습니다.

커뮤니티​

도큐사우루스 커뮤니티는 계속 성정하고 있습니다. 디스코드 채널은 활발하게 활동하고 있으며 스택 오버플로에도 많은 질문과 답변이 오가고 있습니다.

도큐사우루스 2의 모듈형 아키텍처는 커뮤니티에서 서드파티 플러그인을 만들고 게시하는 것을 허용하고 있습니다. 우리는 좀 더 많은 커뮤니티와의 참여를 기대하고 있습니다. 새로운 플러그인을 만들었다면 우리에게 알려주세요.

다음 단계는 뭔가요?​

도큐사우루스 2의 핵심 기능 구현이 거의 끝나가면서 우리는 커뮤니티에서 올라온 문제점과 버그를 해결하는데 더 많은 시간을 할애하며 도큐사우루스가 베타와 릴리스 후보 단계에 도달할 수 있도록 안정적이고 편리하게 개선할 겁니다.

i18n과 버전 관리 기능을 추가하고 React Native나 Jest 같은 대규모 마이그레이션에 대한 경험을 통해 도큐사우루스 1 사이트에 대한 마이그레이션을 좀 더 깔끔하게 지원할 수 있습니다.

하지만 아직 몇 가지 주요 기능에 대한 작업이 남아 있습니다.

2020년에 기여해주신 커뮤니티 여러분께 특히 더 감사드립니다.

  • Joel Marcey는 도큐사우루스를 시작하고 프로젝트 전반에 지원을 아끼지 않았습니다.
  • 코어 개발팀 - Alexey Pyltsyn, Sébastien Lorber, Yangshun Tay
  • 메이저 리그 해킹 그리고 페이스북 인턴 여러분의 눈에 띄는 작업
  • DocSearch 3에 대한 Algolia 팀의 지원
  • Bartosz Kaszubowski는 리액트 네이티브 마이그레이션에 많은 도움을 주었습니다.
  • 커뮤니티 기여자 모두에게 감사드립니다. 서로 격려해주세요.

2021년에도 다같이 힘내자구요! 🎉