문장 다듬기

기술 문서는 명확하고 이해하기 쉬워야 합니다. 이 가이드는 효과적인 문장을 쓰기 위한 핵심 원칙들을 제안해요.

주요 원칙

문장의 주체를 분명하게 하기

  • 도구나 기술, 시스템을 행동의 주체로 사용하지 않아요.
  • 능동형으로 표현해요.

필요한 정보만 남기기

  • 문장을 짧고 간결하게 유지하세요.
  • 메타 담화를 최소화하세요.

구체적으로 쓰기

  • 명사 대신 동사를 사용하세요.
  • 모호한 표현 대신 명확한 표현을 사용하세요.

자연스러운 한국어 표현 쓰기

  • 불필요한 한자어를 제거하세요.
  • 번역체 표현을 자연스럽게 수정하세요.

일관되게 쓰기

  • 공식 기술 용어를 따르세요.
  • 같은 개념을 여러 방식으로 표현하지 마세요.
  • 약어는 먼저 풀어쓴 후 사용하세요.
  • 외래어 표기는 사용 빈도를 고려하세요.