Short sentences make the reader focus on the key point.
Lists and tables change complicated concepts easy to understand.
Short sentences
- Focus each sentence on a single idea.
- Convert some long sentences to lists.
- Eliminate or reduce extraneous words.
- Reduce subordinate clauses. (optional)
I prefer to code in Java and Python because Java is a strong type of language. Strong type is clean and easy to understand, Python can do many things, just like to write web crawlers, machine learning, and several useful tools.
=>
I use two strong type languages:
- Java: mobile app, web…
- Python: crawler, machine learning…
Strong type languages are easy to understand.
Lists and tables
- Choose the correct type of list.
- Keep list items parallel.
- Start numbered list items with imperative verbs.
- Punctuate items appropriately.
- Create useful tables.
- Introduce each list and table.
=>
- Start by whipping egg whites, melted butter, sugar, vanilla extract, and almond extract until frothy
- Add flour, and whip until the flour just disappears
- Shape the batter into small circles on a silicone mat, and notice how thin they are
- Bake until the circles are slightly golden on the edges, then quickly fold the circles in half with the fortune inside, and bring the ends down over the lip of a cup
This series of articles is extracted from Google Technical Writing Courses.
如果你覺得這篇文章很棒,請你不吝點讚 (゚∀゚)