View
3.467
Download
0
Category
Preview:
Citation preview
Clear paragraphs• One idea per paragraph
• One core sentence
• Not too long
• Never randomly add whitespace within paragraphs!
Transition words
Relation Examples of signal words
Enumeration first of all, also, another, furthermore, finally
Cause because, so, due to, for the reason that
Comparison/contrast similarly, likewise, rather, while, in contrast
Conclusion as a result, hence, consequently, therefore
Fuzzy signals seems like, maybe, probably, almost
Emphasis above all, most noteworthy, certainly, even more
Short sentences, simple words• No longer than 20 words per sentence
• Use simple words
• ≤ 3 syllables
• Keep your audience in mind: developers understand ‘pull request’
Passive voiceAvoid when possible!
Passive voice Better alternative
This product can be bought in our webshop.
Customers can buy this product in our webshop.
The employees are informed about their financial contribution.
The manager informs his employees about their financial contribution.
All our posts are checked by a colleague.
A colleague checks all our posts.
Mix it up!• Use synonyms and don’t over-optimize!
• Mix sentence length
• Short and somewhat longer paragraphs
• Variation in word order
Recommended