Translation Guide Book: Korean

번역 규칙

• 아래 딕셔너리에 나열된 단어는 되도록이면 동일한 용어로 번역합니다.
• 고유 명사, 변수명, 메서드명 등은 번역하지 않고 원어 그대로 사용합니다.
  • ex) LangChain, TypeScript, organizationName, getFoo() …
• 한국어만으로 의미가 충분히 전달되는 경우, 한국어 번역 옆에 영어를 남겨두지 않습니다.
  • Do: 개요 (예시)
  • Don’t: 개요(Overview) (예시)
• ‘-입니다.’ 체로 번역합니다.

Dictionary

아래에 나열된 단어들은 Docs에 자주 등장하는 단어로, 동일한 용어로 번역합니다. (상시 추가합니다. 의견 주세요.)

Name	번역	비고
Agent	에이전트
API	(번역하지 않음)
Chain	체인
Chat Models	대화 모델
Component	컴포넌트
Document Loaders	문서 로더
Embeddings	임베딩
End-to-end	(번역하지 않음)
Examples	예시
Getting Started	시작하기	파이토치, 파이어베이스 한국어 문서 참고함
LLM	대규모 언어 모델(LLM)	NVIDIA 한국어 문서 참고함 ‘대규모 언어 모델’보다 LLM이 더 친숙한 사용자가 있음을 감안해 함께 표기함 동일 페이지에 LLM이 여러 번 등장할 경우 LLM으로만 표기함
Message	메시지	국립국어원 규범 표기 기준 ‘메세지’는 허용하지 않음
Prompt	프롬프트
Quickstart	빠른 시작	텐서플로우 한국어 문서 참고함
Retrievers	리트리버
Tool	도구
Vector Stores	벡터 저장소
Workflow	워크플로우

컨트리뷰션 방법

[작업양]

• 135개의 페이지가 있습니다.
  • 작업 기간을 1주일로 잡고 있습니다.
  • 인당 15페이지 정도 변역한다고 했을 때, 하루에 2페이지 정도 분량입니다.
  • 제목만 있는 페이지들도 많아 분량이 많지는 않아 보입니다.
  • 시간적으로 여유가 있다면 더 많이 번역해주셔도 되고, 반대의 경우 조금만 하셔도 됩니다.

[작업 방법]

• 자유롭게 원하는 페이지에 번역, 검수 참여 할 수 있습니다.

  • 한 페이지에 번역 한 명, 검수 한 명 이상이 기여하게 됩니다.
  • 동시에 두 사람 이상이 같은 문서를 작업하는 일이 없도록 간단한 규칙을 만들었습니다.
  • 페이지 별 진행상황에 status 업데이트 해주시면 됩니다.

    [번역 시작할 때]
    - '시작전' -> '번역중'으로 변경
    - 담당자에 자기 이름 올리기
    
    [번역 끝났을 때]
    - '번역중' -> '리뷰 필요'로 변경
    
    [리뷰 시작할 때]
    - '리뷰 필요' -> '리뷰 중'으로 변경
    - 검수자에 자기 이름 등록
    
    [리뷰 끝났을 때]
    - '리뷰 중' -> '완료'로 변경
    

• 브랜치는 feat/[name]으로 지어주세요.

  • [name]은 자신의 이름이나 문서 제목 등으로 unique 하게 지어주시면 됩니다.

• Translator: 일정 단위 번역이 끝나면 docs/korean-translation 브랜치로 PR을 올려 리뷰를 기다려주세요.

  • 초기 번역 작업에서는 작업을 시작할 때 따로 이슈를 만들지 않습니다. 모든 진행상황은 페이지 별 진행상황에서 관리합니다.
  • 단위는 본인이 판단하시면 됩니다. 페이지 하나, 혹은 하나의 토글 등이 될 수 있습니다.
  • 하나의 PR에 너무 많은 내용을 담지 않게만 주의해 주세요.
  • PR에는 작업한 문서 페이지 목록을 꼭 포함해주세요.

• Reviewer: PR이 올라오면 아무나 리뷰를 해주면 됩니다.

  • 번역/컨트리뷰션 규칙을 잘 지켰는지 검수해주세요.
  • 오역이 있는지 검수해주세요.
  • 수정이 필요하면 Request Change, 문제가 없다면 Approve를 해주세요.
  • Approve 후 바로 머지하셔도 되고, 확실하지 않은 부분이 있다면 다른 사람에게 리뷰를 다시 한 번 요청해도 됩니다.