aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorhochan Lee <hochan049@gmail.com>2021-08-15 23:43:43 +0900
committerGitHub <noreply@github.com>2021-08-15 23:43:43 +0900
commitcf4a79fdad7f3527af9ec01f886171784d3f38da (patch)
tree8e6a99b4e73d1f80813d77573289a169cbbe8dca /docs
parentdf43aa5b3d75774d8f1b548ed518120912ee96d1 (diff)
downloadtranslated-content-cf4a79fdad7f3527af9ec01f886171784d3f38da.tar.gz
translated-content-cf4a79fdad7f3527af9ec01f886171784d3f38da.tar.bz2
translated-content-cf4a79fdad7f3527af9ec01f886171784d3f38da.zip
refactor: add feedback(#1773) (#2074)
* refactor: add feedback(#1773) * docs: ㅅ파일변경 이유 설명 추가 * feat: guideline for italics (#1537) * Update docs/ko/translation-guide.md
Diffstat (limited to 'docs')
-rw-r--r--docs/ko/markdown-guide.md18
-rw-r--r--docs/ko/translation-guide.md10
2 files changed, 16 insertions, 12 deletions
diff --git a/docs/ko/markdown-guide.md b/docs/ko/markdown-guide.md
index 3f173cb80d..293e0ba550 100644
--- a/docs/ko/markdown-guide.md
+++ b/docs/ko/markdown-guide.md
@@ -1,21 +1,15 @@
# MDN ko locale Markdown 번역에 대한 일반 지침
-## 존재하는 파일에 대한 변경 (존재하는 파일이 .html 확장자일 경우)
+## .html 확장자에서 .md 확장자로의 파일 변경일 경우
-아래 두 가지 경우에 대해 각각 2개의 commit으로 구분해서 PR을 제출해주세요.
+아래 두 가지 경우에 총 2개의 commit으로 구분해서 PR을 제출해주세요.
-1. 확장자 변경
-2. 내용 변경
+1. 확장자만 `html`에서 `md`로 바꾸고 commit 해주세요.
+2. `html` 형식에서 `md` 형식으로 변경한 뒤 commit을 해주세요.
-다음 [PR](https://github.com/mdn/translated-content/pull/1771)은 모범적인 PR입니다.
-
-### 확장자 변경
-
-이전 html 파일의 Git History 유지를 위해 확장자만 먼저 .html에서 .md로 변경한 후 commit을 해주세요. 확장자 변경 작업이 없을 경우 Git History가 소멸됩니다. 예시는 [확장자 변경 PR](https://github.com/mdn/translated-content/pull/1769/commits/c7937cf2194d218d98394cd7f5f8acebd2e88aa0)를 참고해주세요.
+html 파일에 대한 commit은 오로지 확장자를 바꾸는 것만 허용됩니다. 또한, 전체 commit 개수를 2개를 넘지 않도록 합니다(`squash and merge`가 아닌 `rebase and merge`를 해야하기 때문입니다.). `squash and merge`를 하거나 확장자 변경 작업이 없을 경우 Git History가 소멸되는데, 이전 기여자들의 기록을 남기기 위함입니다. 예시는 [확장자 변경 PR](https://github.com/mdn/translated-content/pull/1769/commits/c7937cf2194d218d98394cd7f5f8acebd2e88aa0)를 참고해주세요.
-### 내용 변경
-
-html 형식에서 md로 형식으로 변경한 뒤 commit을 해주세요. `존재하는 파일에 대한 변경 (존재하는 파일이 .html 확장자일 경우)`에 대한 PR은 `squash and merge`를 할 수 없기 때문에, **해당 단계의 commit의 개수를 1개를 넘지 않게 해주세요.**
+다음 [PR](https://github.com/mdn/translated-content/pull/1771)은 모범적인 PR입니다.
### 리뷰
diff --git a/docs/ko/translation-guide.md b/docs/ko/translation-guide.md
index 44898bdb04..f43ea8b627 100644
--- a/docs/ko/translation-guide.md
+++ b/docs/ko/translation-guide.md
@@ -89,6 +89,16 @@ EDITOR=code
그동안의 MDN 문서에서는 역주로인한 자의적인 해석이 많았고, 전체적인 문서의 품질을 낮췄습니다. 역주가 꼭 필요한 상황이 아니라면 역주는 남기지 않으며, 남기더라도 따로 역주를 표시하지 않고 본문에 포함합니다.
예시: [다음 링크 참고](https://github.com/mdn/translated-content/pull/1385#discussion_r667509255)
+### 기울임꼴
+
+한글은 기울임꼴에 적합하지 않습니다. 전용 이탤릭체가 없다는 것이 첫 이유이고, 문자의 조형이 (정)사각형인 것이 두 번째 이유입니다. [세부 내용 다음 링크 참고](https://github.com/mdn/translated-content/issues/1537)
+
+- 기본 방침은 생략하며, 기여자에 재량에 따라 아래 두 가지 규칙을 따른다.
+ - 한글일 경우 '' 를 tag 대신에 기입한다.
+ - 한글이 아닐 경우 생략한다.
+
+다만 진짜 강조를 해야하는 상황에는, 따옴표로 강조하고 PR로 소명합니다.
+
## 용어 지침
### 공통