[MDN] 6 월 yari-content-ko — 주요 사항과 향후 계획

이전 게시물인 [MDN] - 5 월 yari-content-ko — ko 지역 고정 해제 및 향후 계획에서 MDN 한국 현지화 팀인 yari-content-ko 팀의 시작을 알렸습니다. yari-content-ko 팀은 MDN 한국 문서들에 대해서 완전한 번역이 이뤄질 수 있기를 기대합니다. 이 게시물에서는 6월 MDN 주요 사항들에 대해서 알아보겠습니다.

 

translated-content의 PR 개수 1000개 돌파

translated-content 레파지토리의 전체 PR 개수가 1000개를 넘었습니다. 한국 Pull Request도 100개가 넘을 정도로 많은 분들이 참여해주셨습니다. 모두 기여해주셔서 감사합니다 :)

 

6월 해결 과제 ( learn/javascript 최신화 )

목표가 분명하지 않으면, 할 수 있는 충분한 능력이 있어도 원하는 성장을 이루지 못하는 법입니다. 6월에는 한국 MDN 문서의 빠른 성장을 이루고자 번역을 집중시킬 수 있게 작은 목표를 정했습니다.

 

번역에 /learn/javascript 카테고리를 선정했습니다. 선정에는 아래와 같은 이유들이 있었습니다.

 

• learn 카테고리는 전체 카테고리 중 2번째로 트래픽이 많다. (web 카테고리: 1위)
• MDN에서 현재 HTML 기반 문서들을 Markdown으로 변환하려는 움직임이 보였고 비교적 영향이 적은 카테고리이다.
• 세부 문법 spec과는 별도로 기본 안내서이다.

함께 기여해주신 모든 분들께 감사드립니다. 

 

MDN 문서 Markdown 으로 변환

 

최근 Markdown 변환에 대한 MDN의 공식 입장이 나왔습니다. 자세한 내용은 Converting MDN to Markdown을 참고해주세요. 아래는 해당 Discussions의 간략한 요약입니다. 

---

기존의 HTML 기반 문서들은 현지화 팀 입장에서는 너무 불편했고, 이에 Markdown으로 문서를 작성할 수 있게 yari를 개선하고 있습니다.

 

정확히는 JS 문서(HTML 기반 문서)를 Markdown으로 변환하고 yari를 통해서 HTML로 렌더링 할 수 있게 하는 것이 목표이며, 추가적으로 JS 문서를 Markdown으로 변환하는 작업도 기능에 포함돼있습니다. 현재는 테스트 단계이며, 우선적으로 en-US 콘텐츠에 대해 7월 중순까지 /en-US/docs/Web/JavaScript/ 아래의 모든 것을 변환하여 공개할 것입니다.

 

한편, HTML 기반 문서에 대해서는 영원히는 아니지만 오랫동안 HTML 소스로 작업 할 수 있도록 유지할 것입니다.

 

일부 en-US 페이지들이 Markdown으로 번역이 완료되면 HTML 번역과 동기화 상태를 유지하기가 더 어려울 것입니다. 따라서, 번역된 콘텐츠는 편리해질 수 있도록 빨리 변환하는 것이 좋습니다.

---

우선순위가/ko/docs/Web/JavaScript/ 가 더 높다고 판단돼서 [ko] ⭐6월 해결 과제 ( learn/javascript 최신화 )⭐ 이슈는 추가적인 공식 입장이 나오면 해당 이슈를 닫으려고 합니다. 그전까지 저는 해당 이슈에 관심을 계속 갖고 /learn/javascript에 대해 기본적인 동기화는 끝맺음을 할 예정입니다.

 

브라우저 호환성 관련 class="hidden" HTML 태그 삭제 

아래와 같은 브라우저 호환성 관련 hidden 문단들을 더 이상 문서에 존재해서 안됩니다. 자세한 내용은 All hidden paragraphs about Browser Compatibility can be deleted을 참고해주세요.

<p class="hidden">The compatibility table in this page is generated from structured data.
  If you'd like to contribute to the data, please check out <a
    href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>
  and send us a pull request.</p>

 

$samples URL deprecated

 아래와 같은 $samples URL은 더 이상 사용되지 않으며, 대체되어야 합니다. 자세한 내용은 All uses of $samples URLs are deprecated and need to be replaced을 참고해주세요.

<iframe class="live-sample-frame sample-code-frame" frameborder="0" height="180px" id="frame_Live_example" 
 src="https://mdn.mozillademos.org/en-US/docs/Web/API/Element/compositionstart_event$samples/Live_example?revision=1606277" width="100%"
 ></iframe>

 

향후 계획

6월 All hidden paragraphs about Browser Compatibility can be deleted 해당 PR을 진행하면서, 상당히 많은 부분들이 현지화되면서 형식의 통일이 잘 이뤄지지 않아 추후에 수정하는데 큰 어려움이 많다고 느꼈습니다. 오히려 아직 부족한 것이 많은 지금이 통일화시킬 수 있는 좋은 기회라고 생각합니다. 번역 가이드에 현지화 과정에서 충돌/고민이 많은 단어들에 대해 계속 수집하고 정리할 예정입니다. 

 

Markdown에 대한 MDN의 공식 입장이 나오는 대로 주요 내용을 정리해서 문서를 작성하고, /docs/Web/JavaScript/ 로 다음 번역 목표를 정하려고 합니다. 당장은 7월 중순까지 베타 테스트가 끝난다고 합니다.

 

모두 좋은 하루 보내세요 :) 

 

https://github.com/mdn/translated-content

mdn/translated-content