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.

0 comments
#technical writing #Documentation #Adverbs
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

1
The Beautiful Web
Jens Oliver Meiert • 2 votes
2
When your coding agent doesn’t understand your project, you’ll get junk
Benjamin Cane • 1 votes
3
LLM Use in the Python Source Code
Miguel Grinberg • 1 votes
4
Wagon’s algorithm in Python
John D. Cook • 1 votes
5
An example conversation with Claude Code
Dumm Zeuch • 1 votes