javascript-tutorial / javascript-tutorial/ko.javascript.info

[개선제안] 코드 블럭으로 감싸진 내용 관련 위키 모범사례 추가

オープン
#762 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
HTML
スター
2k
フォーク
852
PR マージ指標
30日以内にマージされた PR はありません

説明

## 자바스크립트 튜토리얼 한국 저장소 개선을 위해 제안할 사항

- [ ] 코드 블럭으로 감싸진 내용 관련하여 위키 모범사례에 추가

## 제안한 이유

번역 진행 시 코드 블럭으로 감싸진 document 관련 내용이 종종 들어있습니다.

ex) Drag'n'Drop 페이지
https://javascript.info/mouse-drag-and-drop

Another important aspect – we track ```mousemove``` on ```document```, not on ```ball```. From the first sight it may seem that the mouse is always over the ball, and we can put ```mousemove``` on it.
But as we remember, ```mousemove``` triggers often, but not for every pixel. So after swift move the pointer can jump from the ball somewhere in the middle of document (or even outside of the window).
So we should listen on ```document``` to catch it.

위 글에서 document를 '문서'로 번역하게 될 경우 번역문이 매끄럽지 않고, 사용자로 하여금 오해할 수 있는 여지가 발생합니다.
따라서, 코드 블럭에 하여금 번역을 하지 않거나, 문장을 그대로 쓰는 음차 번역을 하여 'document'로 작성하고, 이와 같은 내용을 wiki에 추가하려고 합니다.

## 추가적으로 논의할 사항

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

まず、リポジトリの wiki のガイダンスと、javascript.info/mouse-drag-and-drop にある引用された Drag'n'Drop ページを確認します。韓国語訳で `mousemove` や `document` のようなコード形式の用語がどのように扱われているかを確認します。wiki に、このような用語を通常の文章として翻訳せず、そのまま保持するか音訳するための明確なベストプラクティスが含まれていれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript
領域
documentation, localization
issue の種類
ドキュメント
難易度
2/5
見積もり時間
1〜3時間
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。