요약

  • Mozilla의 2020년 10월 설명에 따르면 기존 위키에서는 편집이 곧바로 게시되고, 부적절하면 나중에 되돌렸다. Yari는 풀 리퀘스트에서 먼저 검토하고 공개 페이지를 바꾸는 순서로 옮겼다.
  • 12월 14일 출시 발표 당시 문서는 SQL 데이터베이스에서 저장소 파일로 이동했지만 파일 내용은 여전히 HTML이었다. 홈, 프로필, 검색 페이지는 기존 Django 서비스에 남아 있었다.

먼저 내보내고 나중에 지우던 문장

기술 문서의 오류를 빠르게 바로잡을 수 있다는 것은 위키의 장점이다. 예전 MDN에서는 페이지의 시각 편집기를 열어 문장을 바꾸고 저장하면 수정된 내용이 공개됐다. 운영진은 문제가 있을 때 나중에 되돌릴 수 있었다. Mozilla는 2020년 10월 29일의 전환 설명에서 이 순서를 분명하게 적었다. 저장 버튼을 누른 사람이 공개의 첫 결정을 내렸던 셈이다.

그 길은 스팸에도 열려 있었다. 독자가 먼저 잘못된 내용을 볼 수 있고, 그다음에 관리자가 치워야 했다. 성실하게 고친 사람에게도 피드백이 빈약했다. 수정이 남으면 받아들여진 것 같고, 사라지면 이유를 알기 어려웠다. Mozilla는 별다른 대화 없이 받아들이거나 되돌리는 방식이 기여자와 관계를 맺는 데 좋지 않다고 봤다. 편집을 논의할 때쯤이면 문장은 이미 MDN의 설명으로 등장한 뒤였다.

즉시 편집은 서버 운영에도 비용을 남겼다. 문서는 MySQL에 있었고 Mozilla 팀은 버전 기록, 이전 판의 비교와 표시를 위한 코드를 관리했다. 작성자와 독자는 같은 구조를 이용했다. CDN 캐시는 편집을 빨리 보여주기 위해서도 5분으로 짧게 설정됐다. Mozilla는 트래픽의 99% 이상이 문서를 읽는 요청이라고 밝혔다. 소수의 쓰기 작업에 필요한 속도가 대다수 읽기 요청의 운영 방식에 영향을 준 것이다.

제안은 공개하되 문서는 기다리게 하다

Yari에서는 작성자가 GitHub 저장소 파일을 고치고 풀 리퀘스트를 낸다. 검토자는 질문하고 수정을 요구할 수 있으며, 병합한 뒤에야 빌드와 배포를 거쳐 페이지가 바뀐다. 10월 계획은 매일 배포하고, 기여부터 공개까지 최악의 경우에도 48시간을 목표로 한다고 했다. 이는 출시 전 목표였지, 이후 모든 수정의 실제 소요 시간을 잰 결과는 아니다.

새 순서에는 분명한 이익이 있었다. 잘못된 문구를 독자에게 보이기 전에 걸러낼 수 있고, 기여자와 검토자는 어떤 표현이 나은지 같은 자리에서 이야기할 수 있다. 여러 페이지의 변경을 한 요청으로 묶거나 자동 검사를 돌리는 일도 쉬워진다. Mozilla는 위키 전용 코드를 줄이고 독자에게 미리 생성한 문서를 전달하려 했다. 검토는 공개 뒤의 청소에서 공개 전의 입장 심사로 자리를 옮겼다.

그 대가도 구체적이었다. 페이지 안에 있던 WYSIWYG 편집기가 사라졌다. GitHub 웹 화면만으로 작은 수정은 할 수 있어 명령줄 도구가 꼭 필요한 것은 아니지만, 파일을 고쳐 요청을 내고 병합과 배포를 기다려야 했다. Yari 출시 시점의 문서는 Markdown이 아니라 HTML이었다. Mozilla가 말한 Markdown 전환은 그다음에 해볼 계획이었다. 새 도구가 작은 오류 수정까지 간단하게 만들어 준 것은 아니었다.

옮겨 간 문서와 남아 있던 서비스

Mozilla는 11월 2일 시험 운영을 시작했고 12월 14일 Yari 출시를 알렸다. 문서 기여는 공식 mdn/content 저장소로 보내는 풀 리퀘스트가 됐다. 하지만 홈, 프로필, 검색은 여전히 기존 Django 플랫폼에서 제공됐다. 한 번에 모든 시스템을 갈아엎은 일이 아니었다. 가장 먼저 바뀐 것은 한 문장이 작성자에게서 독자의 화면으로 이동하는 경로였다.

그 경로의 신분증도 바뀌었다. Mozilla는 2021년 7월 공지에서 MDN 계정이 더는 기여에 쓰이지 않으며, 문서를 편집하려면 GitHub에 로그인해야 한다고 했다. MDN 계정 기능은 7월 22일 비활성화할 예정이었다. 누구나 제안할 수 있다는 말은 여전히 가능했지만, 제안의 출입구는 GitHub 계정과 저장소 절차가 맡게 됐다.

두 방식 모두 외부의 수정을 받았다. 그러나 위키에서는 기여자가 먼저 문장을 내보내고 Mozilla가 나중에 취소할 수 있었다. Yari에서는 기여자가 먼저 수정 이유를 제시하고 검토자가 병합을 결정했다. 독자에게 보이는 문서의 모양보다 중요한 변화는 여기 있다. 다음 독자가 읽을 답을 언제 바꿀지 결정하는 손이 달라졌다.