Iain Bean 1/31/2021

Simply write better

Read Original

This article argues against the overuse of adverbs like 'simply', 'easily', and 'obviously' in technical documentation. It explains that these words are subjective, can make readers feel inadequate, and act as filler. Citing talks and articles from Jim Fisher and Chris Coyier, it provides a list of 'inflammatory' words to avoid for clearer, more effective technical writing.

Simply write better

Comments

No comments yet

Be the first to share your thoughts!

Browser Extension

Get instant access to AllDevBlogs from your browser

Top of the Week

2
Designing Design Systems
TkDodo Dominik Dorfmeister 2 votes
4
Introducing RSC Explorer
Dan Abramov 1 votes
6
Fragments Dec 11
Martin Fowler 1 votes
7
Adding Type Hints to my Blog
Daniel Feldroy 1 votes
8
Refactoring English: Month 12
Michael Lynch 1 votes
10