Live data from Hacker News

Write for One Person

wizardzines.com

21–30 of 82 posts

Re: Write for One Person

#21

I never try to speak to everyone as a tech writer. Tutorials are for people who'd never used our software before, but even then I could assume a certain level of computer literacy, for example they can launch out software or browse to a URL. I can make How-to's that can assume they had gone through at least one of the tutorials, but even then I put links to the appropriate tutorials so they could refresh or learn if…

I'd be curious for some more anecdotes and analysis of the "more computer illiterate" line. I've tended to be in pretty siloed environments the last 5 years or so, and haven't noticed it myself, but I've heard some pretty bad anecdotes from people who are in education.

Re: Write for One Person

#22

> Often this person is me I wrote an article that never fails to put a smile on my face every time I read it. I felt like I had finally found my own voice. Ran it through Claude and it told me to tone it down a bit, but I ignored the advice and published it anyway. The article caused people on HN to say I had issues. They weren't exactly wrong, but still. Be careful with what you publish out there. Warm reception is…

<3

Re: Write for One Person

#23

I never try to speak to everyone as a tech writer. Tutorials are for people who'd never used our software before, but even then I could assume a certain level of computer literacy, for example they can launch out software or browse to a URL. I can make How-to's that can assume they had gone through at least one of the tutorials, but even then I put links to the appropriate tutorials so they could refresh or learn if…

People are "getting more computer illiterate" because younger people were never taught computer literacy in the first place. We're past the point where children just automatically learn that by using computers, because computers are too reliable to require acquisition of those skills.

Compare to cars. Once upon a time, every car owner had to know how to maintain a car. Nowadays, you can get along perfectly fine having no idea what's going on under the hood.

Re: Write for One Person

#24
I've spoken before a thousand several times saying with a straight face "Every audience is an audience of one."

My first example, I was asked to give one more talk on how one needs to shuffle seven times. There were four people, and a blackboard smaller than my kitchen window. I went for it like I was in office hours, which I've always enjoyed more than teaching. A few weeks later a phone call "I liked your talk." "Thank you." "Could you come to Switzerland to give it again? We can only offer a week's full expenses..."

Then I was asked to write a review of the off-broadway play "Proof" for the American Mathematical Society Notices. I didn't read it much, but I was told people do. I worked a very hard week on my review; my Swarthmore College classmate Ben Brantley's Broadway reviews were life or death for productions at the time, and I didn't want to embarrass myself. Ron Howard read my review, went to see "Proof" twice and loved it, and hired me to be the math consultant for "A Beautiful Mind". That was a transformative experience.

Every audience is indeed an audience of one.

https://www.ams.org/notices/200009/rev-bayer.pdf

Re: Write for One Person

#25
post #20
post #7

Earlier quoted context omitted.

I can't stand it when LLMs tell you to tone it down. Their writing advice is almost universally awful. They want you to write the most cliched bland content possible. Sometimes I see technical people who feel they aren't good writers, but who have good ideas. They then turn to LLMs, believing that the LLM will help them express their good ideas. They're often right that they have good ideas. But the LLM just turns th…

I feel like LLMs kind of speak to making things be average. For half the population that is a step up, but for the other half that is a step down.

It's right that they steer toward the center of their distribution. But I would offer a different view on whether that's a step up for half the population.

Writing isn't a distribution on a single dimension that goes from "bad" to "good". It's a lot of dimensions that encompass everything from "funny" to "formal", "precise" or "hysterical". They may be filled with metaphors, or use allegory; they may use math or logic to explain. The allegories could be from science fiction or they could be Biblical or 19th century Victorian novels. None of these are right or wrong, but they are opinionated ways to express an idea.

Writing feels better when it has real texture and character to it. That character is not the monodistribution of "bad" to "good". It's whether it inhabits pockets of out-of-distribution thought in the thousands of dimensions of "thought-space."

An LLM pushing to the center of distribution means it pushes the writing out of inhabiting any of the interesting pockets that create the feeling of texture. The middle of the distribution does not mean it is average quality: it means it's not good at all. The median of the distribution can be far worse than the median writer if you accept that the median writer has out-of-distribution thoughts on at least something, and that it is this which makes their thoughts interesting.

That's why a rough, perhaps not-totally-grammatical article written by someone with interesting thoughts is vastly better than a "correct" LLM revision, even if the human writer isn't a 'good' writer. Their article occupies an opinionated stance on some dimension that matters; it sits in a pocket of interestingness that LLMs seem almost totally unable to inhabit.

The exact middle of the distribution across thousands of dimensions may actually be one of the very worst places of them all.

Re: Write for One Person

#26

I never try to speak to everyone as a tech writer. Tutorials are for people who'd never used our software before, but even then I could assume a certain level of computer literacy, for example they can launch out software or browse to a URL. I can make How-to's that can assume they had gone through at least one of the tutorials, but even then I put links to the appropriate tutorials so they could refresh or learn if…

I'd be curious for some more anecdotes and analysis of the "more computer illiterate" line. I've tended to be in pretty siloed environments the last 5 years or so, and haven't noticed it myself, but I've heard some pretty bad anecdotes from people who are in education.

For one company, I made documentation for archive and backup software and I worked closely with tech support. Most customers were sysadmins, and a small subset had no clue what they were doing and they would call us for every little thing even remotely connected to our software. One was a case of an image in a spam email wasn't able to be archived and they were freaking out about the error.

I also worked at a university and that was concerning because some students would just give up whenever anything didn't go right the first time. No troubleshooting skills at all. We were moving from Google to MS and they needed to use Takeout to backup their stuff locally, just in case something happened. But we got a lot of calls because it wasn't ready to download immediately. I've heard it's gotten worse.

Re: Write for One Person

#28

> Often this person is me I wrote an article that never fails to put a smile on my face every time I read it. I felt like I had finally found my own voice. Ran it through Claude and it told me to tone it down a bit, but I ignored the advice and published it anyway. The article caused people on HN to say I had issues. They weren't exactly wrong, but still. Be careful with what you publish out there. Warm reception is…

One time a project I made appeared at the very top of the front page. It attracted many negative comments. Some saying it was barely usable. Others saying I'd built it wrong, and offering half-baked advice on how I should have done it instead. That project later went on to get me lots of work and recognition, and even won me a few industry awards. HN posters tend to be overly critical, often tripping over themselves…

Negativity normally doesn't faze me. It's the insinuations of mental illness that hit me pretty hard. I quit the GNU bash mailing list after someone called my idea "schizophrenic", then like a year later I found out bash actually implemented a version of my library system idea.

Very often I think I'm insane because of the things I think. If it was so easy, much smarter people would have done it already. Then I write the program and it actually works.

Re: Write for One Person

#29
This reminds me of some comments by C.S. Lewis (paraphrasing from memory) on three ways of writing for children, two good and one bad:

- Writing for a specific child (think telling a story to someone specific)

- Writing because you have something to say and a story is how you want to say it

- Writing generally what you think a group of people want (e.g. "children like food so I'm writing a story about food")

I think the essay is available online, he is much more eloquent than I

Post reply on HN