Active Voice
기술 문서에서는 대부분의 문장을 능동태로 작성하는 편이 좋습니다.
Distinguish active voice from passive voice in simple sentences
수동태 문장에서는 주어가 생략되기도 합니다. 하지만 이런 경우 독자는 추측할 수 밖에 없습니다.
명령형 동사는 일반적으로 능동태입니다. 이 경우 암시적으로 주어는 읽는 you를 가리킵니다.
1. Open the configuration file.
2. Set the `Frombus` variable to `False`.
Distinguish active voice from passive voice in complex sentences
대부분의 경우에 수동태 문장을 능동태로 변환하면 문장이 더 명확해집니다.
before
성능이 사용자에 의해 측정되었습니다.
after
사용자가 성능을 측정했습니다.
active voice vs passive voice
능동태를 사용해야하는 이유는 무엇일까요:
- 명확성: 누가 무엇을 했는지 독자가 바로 알 수 있게 합니다.
- 간결성: 불필요한 단어를 줄여서 간결하게 합니다.
수동태를 사용해야할 경우도 있을까요? 우선 동작의 주체가 중요하지 않을 경우가 있습니다.
버그가 수정되었습니다.
위의 경우, 누가 버그를 수정했는지보다 수정되었다는 사실이 더 중요합니다. 다음은 주체가 불명확할 경우입니다.
오류가 발견되었습니다.
위의 경우, 누가 오류를 발견했는지 명시할 필요가 없거나 알 수 없습니다. 마지막으로 동작의 대상이 강조되어야할 경우입니다.
파일이 삭제되었습니다.
Wrap Up
능동태를 사용하면 문서가 더 명확하고 간결해집니다.
Summary
능동태는 독자가 쉽게 이해할 수 있도록 문장을 명확하게 만듭니다. 또한, 불필요한 단어를 줄여 문장을 간결하게 합니다. 하지만, 주체가 중요하지 않거나 불명확한 경우에는 수동태를 사용할 수 있습니다. 상황에 맞게 능동태와 수동태를 적절히 사용하여 효과적인 기술 문서를 작성하세요.