문장 다듬기
기술 문서는 명확하고 이해하기 쉬워야 합니다. 이 가이드는 효과적인 문장을 쓰기 위한 핵심 원칙들을 제안해요.
주요 원칙
- 도구나 기술, 시스템을 행동의 주체로 사용하지 않아요.
- 능동형으로 표현해요.
- 문장을 짧고 간결하게 유지하세요.
- 메타 담화를 최소화하세요.
- 명사 대신 동사를 사용하세요.
- 모호한 표현 대신 명확한 표현을 사용하세요.
- 불필요한 한자어를 제거하세요.
- 번역체 표현을 자연스럽게 수정하세요.
- 공식 기술 용어를 따르세요.
- 같은 개념을 여러 방식으로 표현하지 마세요.
- 약어는 먼저 풀어쓴 후 사용하세요.
- 외래어 표기는 사용 빈도를 고려하세요.