Stop trying to engineer your way out of listening to people

There is a very weird and a very awesome soviet-era movie Kin-dza-dza. At one point one of the characters tells this about the other: "he says things what he does not think, and he thinks things what he does not think."

I was the yielding type, not speaking up, letting others take charge. In my experience, it's not always worth it, especially if you care about the thing you are working on. I went so far as to just dissociate from everything and distance myself from others. The problem is that people deserve your honest opinion if you care about them, even if it's not what they want to hear. But it's so hard to spend mental energy to listen, correct, try to prove your point... even if you succeed, they will resent you for it.

Some people are just too stubborn, especially if they come from a place of authority and seniority. I'm doing house repair work right now with an older relative. He learned how to do repairs and renovations by himself, things like working laminate floors, mortar, laying tiles etc. The things is, he has his own reasoning and rhythym of doing things and doesn't like to be challenged, but I feel his ways don't always make sense, esp when I feel he is rushing and improvising (a programmer can tell). I haven't done much handy work myself in the past, but I'm a millennial, so I google things, watch youtube videos, and I read instructions. I also know that it isn't rocket science, my parents built our own home brick by brick. And now, every step of the way I have to be pushy to get my way, and make it sound like I'm not imposing or too nitpicky or challenging his "expertise", it's very taxing, I made a big scene once already and the whole relationship is now strained.

I tend to be very exacting in my word choice. If I used a specific word, I meant it. Many people I find speak in what I would describe as tone poems. They circle around an idea using whatever word is within reach, and expect you to understand the meaning based on shared connotations. These people are tiring to interpret. When I write something, each and every word was chosen specifically and with intention.

The number of times I see my words interpreted as though my choice in words had been imprecise is a near constant source of pain, particularly in the workspace. I might be on the spectrum, I am undiagnosed.

About six months ago I was tasked with building a little RPC for a different division to be able to kick off a long running process and documenting it for them. The documentation was complete, correct, and relatively terse. Less than a page.

I sent my manager the documentation to pass on, and for reasons I will never understand he passed it through AI before handing it over to the other department. No one informed me.

Within a day I start getting feedback that makes zero sense. Seemingly no one can get the RPC to work. I had tested this extensively, the complaints made zero sense. One of the complaints includes the actual request being made and the endpoint is entirely wrong. Not a single character typo, a complete fabrication. I ask where this came from and they point me to the documentation they were sent. Every single thing was wrong. The endpoints were wrong, the required parameters were wrong, there were invented features that do not exist. I am a very easy going guy, and I have genuinely never been so furious in my entire life. I am still angry as I write this. If the job market were not what it is I would have quit there and then.

I feel like people using AI to both read and interpret language is the death of rigorous language. I have genuinely been pondering for months if generative AI is the "Great Filter" preventing space faring civilizations from flourishing. Around the same time a civilization begins to enter space they invent a device that destroys their minds.

Perhaps you should ask the manager why he passed it through AI.

It might be that with precision, readability is lost. It's a tradeoff: the more compressed your language is, and hence the more precise, the more cognitive effort you require the reader to expend on each word. Reading is a translation from your mental model, as expressed in words, to the readers mental model. Words alone don't perform this translation, the act of reading and interpreting does so. With your concision you give no help to the reader in this process.

One suspicion I have is that your one-pager was passed through AI because it was too terse to serve the job of aiding the general reader in obtaining an understanding of the topic for themselves.

Writing to be read by an audience is a vastly different activity than writing notes that merely, precisely, document for the maximally informed highest-context reader (or one willing to do the work of reassembling this context during reading).

When you're writing for others, especially a "generic other", you're expected to adopt their uninformed, low-context, high-difficulty reading position, and fill-out the prose in an aid to their understanding.

This will involve: repetition (restatement with different words and ideas), illustration with simple examples, grounding in examples most likely to be familiar to them, explicit statement of steps/procedures/processes that breakdown topics/actions into small units which are each easy to immediately understand, possibly: some humor to break the effort of reading, some asides which engage or interest the reader, some context which makes the reading reelvant to them so they will be willing to expend the effort to read it.