javascript-tutorial / javascript-tutorial/ko.javascript.info
[개선제안] 코드 블럭으로 감싸진 내용 관련 위키 모범사례 추가
- 主要言語
- 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