Clear Sentences
Choose strong verbs
be 동사 형태를 제거하고 명확한 단어를 선택하세요. 이를 통해 문장에서 행위자가 명확해지고 능동태로 작성할 수 있습니다.
Reduce there is / there are
'There is'를 제거하면 일반적인 주어를 더 나은 주어로 대체할 수 있습니다.
There is a variable called met_trick that stores the current accuracy.
A variable named met_trick stores the current accuracy.
The met_trick variable stores the current accuracy.
Minimize certain adjectives and adverbs (optional)
형용사와 부사는 기술 문서를 읽는 독자에게 모호하고 주관적으로 느껴질 수 있습니다.
Setting this flag makes the application run screamingly fast.
Setting this flag makes the application run 225-250% faster.
기술 문서에서는 마케팅적인 용어보다는 사실적이고 객관적인 수치 정보를 제공하세요.
Wrap Up
이 가이드에서는 기술 문서에서 명확하고 간결한 문장을 작성하는 방법을 다뤘습니다. 이러한 방법을 적용하면 글의 가독성을 향상시킬 수 있습니다.
Summary
명확한 문장을 작성하려면 적절한 동사를 선택하고, 'there is'와 'there are'의 사용을 줄이며, 특정 형용사와 부사를 최소화해야 합니다. 강한 동사는 문장을 더 능동적이고 직접적으로 만듭니다. 'there is' 구문을 더 나은 주어로 대체하면 명확성이 향상됩니다. 모호한 형용사 대신 구체적인 수치 정보를 제공하면 객관성이 높아집니다.