# 번역할 콘텐츠 작성

설명서는 여러 언어로 번역됩니다. 영어 설명서를 작성하는 방법을 사용하면 번역 품질이 크게 향상될 수 있습니다.

## 번역에 친숙한 콘텐츠 작성 정보

다음 지침을 사용하여 만든 콘텐츠를 성공적으로 번역할 수 있는지 확인합니다. 자세한 내용은 [스타일 가이드](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/style-guide)를 참조하세요.

* 일반적이고 대부분의 사용자가 이해할 수 있는 예제를 사용합니다.
* 그룹에 대해 논란의 여지가 있거나 문화적으로 특정한 예제는 사용하지 않습니다.
* 활성 음성으로 작성합니다.
* 간단하고 짧고 이해하기 쉬운 문장을 작성합니다.
* 텍스트를 불분명하게 만들 수 있는 대명사를 너무 많이 사용하지 마십시오.
* 속어와 농담을 사용하지 마십시오.
* 부정적인 문장을 사용하지 마십시오.
* 가능하면 업계 표준 약어를 사용하고 사용자 지정 약어를 설명합니다.
* 직설법을 사용합니다.
* 중복 및 장황한 표현을 제거합니다.
* 누적 수식어(명사 문자열)를 과도하게 사용하지 마세요. 번역기는 수정 중인 명사 중 어떤 명사인지 오해할 수 있습니다.
* 첫 번째 명사에서 단수 또는 복수로 되어 있는지 명확하지 않은 보이지 않는 복수를 피합니다.
* 명목화를 피하십시오.
* 모호한 모달 보조 동사를 사용하지 마십시오.
* 성별별 단어를 사용하지 마세요.
* 전치사 구를 사용하지 마세요.
* 모호한 명사 및 대명사(모호한 문장 제목)를 피합니다.
* 인라인 링크를 최소한으로 유지합니다. 필요한 경우 "자세한 정보는 '링크 제목'을 참조하십시오."와 같은 문구로 시작해 주세요. 또는 항목의 끝에 있는 "추가 읽기" 섹션에 관련 링크를 추가합니다.

## 예제

이 섹션에서는 번역에 친숙한 설명서를 작성하기 위한 지침을 따르는 방법에 대한 예제를 제공합니다.

### 국가별 정보 방지

예를 들어 800개의 숫자와 국가별 주소를 사용하지 않도록 합니다. 필요한 경우 정보가 적용되는 국가를 언급하세요.

### 누적 한정자(명사 문자열)의 과도한 사용 방지

겹쳐진 수식어가 많으면 무엇이 무엇을 수식하는지 파악하기 어려워 잘못된 번역이 발생할 수 있습니다. 예를 들어 "퍼블릭 리포지토리 기본 원본 설정" 대신 "퍼블릭 리포지토리 기본 원본 설정"을 사용합니다.

### 보이지 않는 복수 방지

예를 들어 "파일 검색"이라는 용어를 사용하는 경우 파일 하나 또는 모든 파일을 검색하는지 여부가 불분명합니다. 모호성을 제거하기 위해 더 많은 컨텍스트를 제공합니다. 지정된 예제에서는 "모든 파일 검색" 또는 "source.md 파일 검색"을 사용할 수 있습니다.

### 명목화 방지

예를 들어 "결론에 도달하기 위해" 대신 "결론"을 사용합니다.

### 모호한 모달 보조 동사를 사용하지 마십시오.

"may" 및 "might"와 같은 단어를 사용하지 마세요. 모호성을 방지하려면 더 명확하게 해야 합니다.

### 전치사 구 피하기

"여러 번 시도한 후" 또는 "리포지토리 로그에 따라"를 작성하는 대신 더 직접 씁니다. 예를 들어 "세 번 시도한 후"입니다.

### 모호한 명사와 대명사를 피하세요.

모호한 명사 및 대명사는 특히 콘텐츠를 번역해야 할 때 누가 또는 무엇을 참조하는지 불분명하게 만들 수 있습니다. 예를 들어 "유지 관리 관리자 및 기여자 파일 및 주석에 액세스할 수 있습니다. 끌어오기 요청에서 수정 작업을 합니다. 이 문장에서는 파일 또는 주석이 변경되고 있는지 명확하지 않습니다. 대명사가 둘 이상의 선행을 참조하는 것처럼 보이는 경우 선행을 명확하게 하기 위해 문장을 다시 입력하거나 명사를 명사로 바꿔 모호성을 제거합니다.

### 인라인 링크를 최소한으로 유지합니다.

가능한 경우 스타일 가이드에 따라 링크를 명확하게 소개합니다. 예를 들면 다음 문장을 대신

```markdown
Read [more about OAuth2.](/apps/building-integrations/setting-up-and-registering-oauth-apps/) Note that OAuth2 tokens can be [acquired programmatically](/rest/reference/oauth-authorizations/#create-a-new-authorization), for applications that are not websites.
```

대신 이걸 사용할 수 있습니다.

```markdown
OAuth2 tokens can be acquired programmatically for applications that are not websites. For more information, see [AUTOTITLE](apps/building-integrations/setting-up-and-registering-oauth-apps/) and [Create a new authorization](/rest/reference/oauth-authorizations/#create-a-new-authorization).
```