ZH version is available. Content is displayed in original English for accuracy.
Advertisement
Advertisement
⚡ Community Insights
Discussion Sentiment
89% Positive
Analyzed from 622 words in the discussion.
Trending Topics
#said#money#docs#writing#language#documentation#lossless#natural#another#agent

Discussion (10 Comments)Read Original on HackerNews
Every time natural-language passes from one human to another whether verbally or in the written word, there is a greater than zero percent chance that the meaning will be received/understood in a way that is "lossy" compared to the communicating party's intent. The so-called "telephone game" is a very good example of this.
It seems true that the lossy problem arises even without any LLMs or any intentional transformations.
Lossless in other domains basically means perfect-fidelity carried across copies. Natural language seems almost incapable of this ideal.
She SAID she did not take his money.
She said SHE did not take his money.
She said she DID not take his money.
She said she did NOT take his money.
She said she did not TAKE his money.
She said she did not take HIS money.
She said she did not take his MONEY.
8 very different messages all containing the same words in the same order. If the emphasis is changed or lost between sender and receiver, the message itself is lost regardless of the faithful reproduction of the actual words.
In the context in which I work, the quality of these docs is sufficient.
Unless your docs are being read by thousands of people, in 2026, in most contexts, handwriting docs adds less value than writing high quality instructions to your agent.
There are exceptions. For example, when kicking off a project, short crisp prose in a product brief aligns a team, removes uncertainty, and clarifies decisions. These are worth hand writing.
Are the instructions not docs?
Another way this could go is that you simply don't need to communicate your ideas to another person anymore, that everyone hyper-specializes into their own language, if not just straight up the AI scanning your brain.
Of course there are. The article simply defines "transformation" such that it excludes the lossless ones. :-)
bars!!
> Writing is thinking. Spending time on the writing process — on deciding what to emphasize and how to structure your ideas clearly — teaches you more about your topic. If you circumvent this process, you will probably walk away with a poorer understanding of the subject matter.
This is a point with which I completely agree.
It is extremely frequent that only when you write a detailed documentation for the product that you have designed, you finally understand some of its finer points, which perhaps need some last-minute changes, to prevent future problems.
Because of this, I despise the companies where the project plans do not allocate an adequate time for writing documentation, believing that this is some kind of unproductive activity. I have worked at many companies, in many countries, and without exception the best productivity, measured in the rate of completing projects that worked OK in production or at customers, was at the companies where the project schedules seemed to be more relaxed, by allocating a generous time for writing documentation.
Also when I was a child, much of what I did learn I learned by trying to explain those things to my schoolmates, and this was significantly more than I had learned directly from teachers.