When I was a student, most of the good people I worked with gave me an advice: "Write in a way your readers will understand." This is a good guiding principle applicable in many contexts. This means that you should try to always call the same things the same name, to introduce all the terminology before using it, and to be clear as you can. Now, when I read a paper and cannot follow an argument, I usually blame the writer, not my own stupidity.
The same applies to code. There are clever tricks and hacks that looks like a piece of art, but often they are not worth it. The code is meant to be read as maintaining usually is spread over years. It is essential to understand a piece of code to avoid bugs when changing it, especially if the code is related to many other internal parts.
The same applies to emails. When I get a two-screen letter without a clear subject, and a question, I will likely just close it. If I do not understand what a person wants from me, it is unlikely I will able to help them.
We are now in the new reality when producing a large amount text is fast and easy. Content creators are salivating and are producing a shitload of cringe posts on social media. Open source "contributors" are generating 20k-line PRs assuming they are making world a better place. Academic conferences receive more and more automatically generated papers that even the "authors" do not understand. The "authors" themselves often do not have the stamina to read what they have just generated. It is absurd! Your truly has also been affected by that. I used to post generated daily summaries of arxiv papers until I realised that there are already summaries of arxiv papers: titles and their abstracts.
But the main catch is that nobody reads this stuff. We live at a time of graphomaniacs, not at a time of readers. Most of the text out there is now to be written, posted, and liked, not to be read, understood, and discussed. My solution to this is to get away from the places where this is the norm, and focus on producing text that people can read, understand, benefit from, and give me feedback for.