TRANSLATION_GUIDE.md

일반 규칙

• 번역된 문서만으로도 내용을 이해할 수 있도록 문서를 번역해야 합니다.

  • 기계적인 번역이나 피상적인 리뷰는 지양해주세요.
  • 일반 명사와 Class 이름은 구분하여 번역을 하거나 원문을 표기합니다. * 예시. 데이터셋과 Dataset

• 허브 모델 문서의 meta description도 번역에 포함됩니다.

  • 문서 상단의 meta description의 summary 내용도 가급적 번역합니다.
    • 예시.

    layout: hub_detail
    background-class: hub-background
    body-class: hub
    title: MobileNet v2
    👉summary: residual block을 통해 속도와 메모리에 최적화된 효율적인 네트워크
    ⋮
    

• 반드시 문서를 직역하지 않아도 됩니다.

  • 의미 없는 주어는 생략해 주세요.
    • 예를 들어, we는 강조의 의미가 있지 않는 이상 번역하지 않고 생략합니다.
  • 이해를 돕기 위한 약간의 의역이나 설명을 추가해도 좋습니다.
    • 단, 원문의 의미가 다르게 해석될 여지가 있는 경우에는 자제해주세요.

• 쉬운 유지보수를 위해 문장 단위는 가급적 지켜주시기 바랍니다.

  • 하지만 문장이 여러 줄에 걸쳐 조각나 있는 경우 등에는 한 줄에 하나의 문장으로 모아주셔도 됩니다.

• 번역된 문장만으로 의미를 전달하기 어려울 때에는 한글(영어)를 같이 작성합니다.

  • 해당 용어가 처음 출현하였을 때 한글(영어)로 작성하고 그 이후에는 한글만 작성합니다.

• 현재 허브의 문서에서 사용되는 용어는 튜토리얼 용어집을 기준으로 하고 있습니다.

• 소스 코드, 논문 제목 등은 가급적 번역하지 않습니다.

  • 단, 소스 코드에 포함된 주석은 가급적 번역합니다.

• 줄 바꿈 및 공백은 가급적 원문과 동일하게 유지합니다.

  • 이후 원본 문서에 추가적인 변경이 발생할 때 유지보수를 돕습니다.
  • 너무 긴 문장은 가독성을 고려해 줄 바꿈을 추가해도 좋습니다.