Implicitly downplaying knowledge in technical communication
jamesg.blog
jamesg.blog
It minimizes the effort that is sometimes required to understand or accomplish something. This is particularly problematic when there’s a difference of skill or knowledge.
Remember that what seems simple to the master seems impossible to the student. That’s sort of the definition of mastery. If the master wishes to teach, perhaps they should avoid causing emotional injury to the student.
The problem is that many technical writers want the thing they are describing to just be easy, because they are selling a solution. But you wanting something, doesn't make it so.
On top of that what is easy is relative. To a life long programmer with administrator-experience a thing might be easy and obvious, to someone who never opened a CLI and is not a programmer it might not be.
IMO it is benefitial for technical documentation to be written in a way that does not assume too much prior knowledge.
TL;DR: reserve words like just, easy and simple for things that — to the layperson — are truly just, easy and simple