본문으로 건너뛰기

도큐사우루스 2021년 회고

· 약 14분
조슈아 첸(Joshua Chen)

도큐사우루스는 2021년에도 엄청난 일들을 해냈습니다! 빠르게 성장하고 있으며 깃허브에서는 3만개의 별을 받았습니다.

국제화 기능 출시 이후 버전 1과 차이 없이 같은 수준의 기능에 도달했습니다. 첫 번째 베타를 발표했으며 훨씬 더 많은 사용자가 생겼습니다.

이제 공식적인 v2 릴리스가 얼마 남지 않았습니다! 추가적인 정보는 roadmap issue 항목을 참고하세요.

새로 추가된 기능

2021년에 추가된 몇 가지 주요 사항을 살펴보는 것으로 시작해보죠. 반 년전에 공개했던 할일 목록을 기억하시나요? 다시 꺼내서 우리가 얼마나 멀리 왔는지를 살펴볼 시간입니다!

  • 국제화: 2020년 말에 일부 공개한 이후 4개월만에 공식 출시했습니다. 수 많은 프로젝트에서 성공적으로 적용한 사례를 만날 수 있습니다.
  • 사이드바 자동생성: 이제는 sidebars.js 파일을 건드릴 필요가 없어졌습니다.
  • 웹팩 5: 빌드 성능이 크게 향상됐습니다.
  • 트레일링 슬래시 설정: 다른 콘텐츠 호스팅 제공업체와 원활한 통합을 지원합니다.
  • 모바일 탐색 기능 리뉴얼: 모바일 환경에서도 데스크탑과 같은 모든 탐색 기능을 지원합니다.
  • UI 개선: 접근성 텍스트 보완, 준수사항 개선, 위로 가기 버튼 등
  • 블로그 저자 표기: 하나의 블로그 포스트에 참여한 모든 저자를 표시할 수 있습니다!
  • 블로그 기능 개선: 아카이브 페이지, SEO를 위한 구조화된 데이터, 피드를 위한 전체 포스트 등의 기능을 갖춘 블로그를 즉시 사용할 수 있습니다.
  • 애셋 집합: 더 이상 static 폴더에 파일을 쌓아놓을 필요가 없습니다. 마크다운 파일과 같은 위치에 이미지를 배치합니다.
  • 사이드바 카테고리 색인 페이지: 카테고리 라벨과 페이지를 연결해 문서 구성을 개선할 수 있습니다.

시간이 지나면서 코드도 안정적으로 다듬었습니다. 테스트 범위를 개선하고 모든 패키지를 타입스크립트로 이전했습니다. 배포하는 번들 크기도 최대 60%까지 줄였습니다.

추세

npm

도큐사우루스 v2는 지속적으로 성장하고 있습니다. v2는 v1에 비해 8배 많은 설치 횟수를 기록했습니다. 주간 단위 내려받기 숫자도 1월 초 28,066건에서 12월 중순 86,846건으로 3배(+209.4%)가 늘어난 것을 확인했습니다.

2021년 도큐사우루스 v1, v2의 npm 트렌드. 도큐사우루스 v2의 설치는 지속적으로 증가하고 있으며 v1은 거의 일정한 추세를 보여주고 있습니다. v1 설치는 10000 정도에서 유지되는 반면 v2는 30000에서 90000으로 증가했습니다. 2022년 1월 전에 90000에서 40000으로 급격하게 숫자가 떨어졌습니다.

(하지만, 크리스마스 시즌 하락세는 피해갈 수 없었습니다).

2.0.0-alpha.71 부터2.0.0-beta.14까지 18개의 버전을 릴리스했습니다. 20일마다 한 번씩 출시한 속도입니다.

깃허브

  • : 20,460 → 29,679 (전년대비 +45.1%). 그리고 이 글을 쓰기 직전에 별 3만개를 달성했습니다.
  • 전체 기여자: 512 → 773 (전년대비 +51.0%).
  • 라이브러리 사용 프로젝트: v2 5,039 → 14,579 (전년대비 +189.3%), v1 6,311 → 7,581 (전년대비 +20.1%).
  • 커밋: 1,187번의 커밋. 매 주 23번의 커밋이 발생했습니다.
  • 이슈: 619건의 이슈가 등록됐고 그 중 505건이 처리됐습니다.
  • 새로운 핵심 멤버가 합류했습니다 (그게, 접니다 😝)

별이 증가하는 추세는 매우 긍정적입니다. 비슷한 프로젝트와 비교했을때 우리는 정말 빠르게 성장하고 있습니다.

주요 9개 정적 사이트 생성 도구의 별 획득 추세 Next.js가 가장 빠르게 성장하며 도큐사우루스는 성장률 측면에서 4위입니다.

8400개의 별이 증가해 우리는 Next.js와 Astro에 이어 올해 JavaScript rising stars of static site generators에서 3위를 차지했습니다.

"정적 사이트" 순위 목록에서 도큐사우루스가 3위를 차지했습니다.

주요 사용자 사이트

도큐사우루스 2의 플러그형 아키텍처의 진정한 잠재력을 보여주는 몇 가지 새로운 사이트가 쇼케이스에 추가됐습니다.

Iota wiki 밝은 모드Iota wiki 어두운 모드

Dyte 밝은 모드Dyte 어두운 모드

Ionic 밝은 모드Ionic 어두운 모드

Courier

도큐사우루스 사용자의 창의성은 상상을 초월합니다. 🤩 우리는 도큐사우루스의 콘텐츠 기능을 사용하면서 독창적인 테마 디자인을 적용하는 사용자가 점점 더 많아지기를 기대합니다! 여러분의 사이트에서 도큐사우루스를 사용하고 있다면 쇼케이스에 추가할 수 있도록 알려주세요.

커뮤니티

저는 디스코드에서 중재자로 활동하면서 커뮤니티가 성장하는 것을 분명하게 확인할 수 있었습니다. 자주 묻는 질문을 문서에 추가했고 일부 기능 요청도 반영했습니다. 프로젝트와 커뮤니티는 서로에게 도움이 됩니다. 예를 들어 저는 프로젝트 관리자가 되기 전에 커뮤니티 기여자였습니다.

트위터에서도 굉장한 피드백이 자주 언급되고 있습니다.

@docusaurus는 정말 굉장해요! 이렇게 간단한 사용법은 믿을 수가 없습니다.

추가적인 플러그인, 도구, 컴파일 단계는 필요 없습니다. 지금 바로 사용할 수 있어요.

난 정말 @docusaurus를 사랑해요. 도큐사우루스가 없었다면 API, 튜토리얼, 블로그를 워크플로우에 포함해 효율적이고 우아하게 만들 수 없었을 겁니다.

우리는 여러분의 피드백을 하나 하나 모아놓고 있습니다. 😄 도큐사우루스를 즐기고 있다면 코멘트에 태그를 달아주세요!

공식 릴리스가 가까워지면서 플러그인 개발자, 커스텀 사이트, 모든 신규 사용자에 대해 더 많이 알고 싶습니다. 여러분이 필요로 하는 것을 개발에 반영할 수 있도록 여러분이 하는 일에 대해 계속 알려주세요.

앞으로의 일정

지난 몇 달 동안 우리는 도큐사우루스 RC 버전에 대해 이야기해왔으며 이제 거의 다 왔습니다. 다음 단계로 나아가기 전에 해결해야 할 모든 문제를 추적하는 용도로 마일스톤을 만들었습니다. 우리는 좀 더 강력한 테마 워크 플로우를 만들어 사이트 관리자가 업그레이드 시 변경 사항을 두려워하지 않고 기본 테마를 수정할 수 있게 만들겁니다. 여기에는 다음과 같은 사항이 포함됩니다.

  • 컴포넌트 구성 지침. 테마 컴포넌트가 적절하게 분류되어 사이트에서 수정하고자 하는 기능을 수행하는 컴포넌트를 바로 찾을 수 있게 합니다.
  • swizzle CLI 기능 향상. 사용자가 불편함 없이 사용할 수 있고 가능한 모든 시나리오에 적용할 수 있게 합니다.
  • 테마 API 리팩토링. 바꿀 수 있는 모든 컴포넌트는 실제로 바꿀 수 있도록 UI가 아닌 컴포넌트를 재배치합니다.
  • 문서. 코드를 처음 작성하는 개발자부터 숙련된 개발자까지 모두가 필요한 정보를 문서에서 얻을 수 있기를 바랍니다. 모든 기술 수준에 도움을 줄 수 있는 좀 더 진보적인 튜토리얼을 구성합니다.

로드맵 관련 이슈에서 도큐사우루스 2.0 계획을 좀 더 자세히 살펴볼 수 있습니다. 2.0은 커뮤니티의 도움으로 더 큰 릴리스 될 것입니다. 마일스톤 이슈에 대한 의견과 제안은 언제든지 공유해주세요!

코어 팀에서 GA 릴리스를 제공하기 위해 열심히 노력하고 있으며 2.0 이후 다른 유용한 기능은 마이너 버전으로 릴리스할 계획입니다. 3.0 아키텍처 변경에 대한 추가적인 계획도 준비되어 있습니다!

도큐사우루스 2.0 공식 출시와 함께 훨씬 더 많은 v1 사이트에서 이를 채택하고 마이그레이션할 것을 확신하고 있습니다.

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

  • 코어 팀: Alexey Pyltsyn, Sébastien Lorber, Joshua Chen, Yangshun Tay는 커뮤니티 중재, 도큐사우루스 홍보, 이슈 분류, 새로운 기능 구현을 담당했습니다.
  • Joel Marcey는 도큐사우루스를 처음 시작했고 개발 전반에 지원을 아끼지 않았습니다.
  • 도큐사우루스 사용자를 위해 알골리아(Algolia) 팀에서는 새로운 DocSearch로 마이그레이션을 지원하고 검색 관련 문의에 답변해주었습니다.
  • 코드에 기여하고 문서를 개선하고 디스코드에서 질문에 답변해주신 모든 커뮤니티 회원에게 감사드립니다.

2021년에도 모두 수고하셨습니다. 멋진 2022년을 맞이하자구요!