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

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

Open
#762 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
2k
Forks
852
PR merge metrics
No merged PRs in 30d

Description

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

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

## 제안한 이유

번역 진행 시 코드 블럭으로 감싸진 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에 추가하려고 합니다.

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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the repository wiki guidance and the cited Drag'n'Drop page at javascript.info/mouse-drag-and-drop. Check how code-formatted terms such as `mousemove` and `document` are handled in the Korean translation. Done means the wiki includes a clear best practice for preserving or transliterating such terms without translating them as ordinary prose.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation, localization
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.