Just Simply – Stop saying how simple things are in our docs
Or maybe -- controversial opinion here -- people shouldn&#x27;t be such babies. I&#x27;m looking around the HN discussion here and can&#x27;t quite believe how personally offended people are by these words.<p>Yes, at the beginning of the first semester at university, hearing a math professor say a step is &quot;trivial&quot;, when it was quite hard, was a bit grating. One month in, I realised that the intended meaning of the word was that no special clever trick was required to make the deduction, just a lot of perseverance.<p>Similarly, when documentation mentions to &quot;simply&quot; do something, and I don&#x27;t get it, isn&#x27;t that a clear hint that I&#x27;m still missing a concept somewhere and need to look around for an explanation?<p>What I wonder is: Why is this so personal? Are people really shamed into quitting their career over a misplaced &quot;simply&quot; in a piece of tech writing because it triggers their impostor syndrome? Is that the reason why tech documentation has slowly been evolving into 50-minute step-by-step YouTube tutorials that start with installing the IDE? What happened to the expectation of people being adults?