News for hackers. Stuff that matters.
Re:Let's Talk About Writing in Tech by nrclark on Sunday June 22, 2025 @03:41PM (#44349687)
I'm not sure about that. For whatever reason, I've noticed that my brain has a hard time holding onto ideas from LLM-written documentation. Maybe because LLMs generate the mathematically lowest-energy thing that they can.

I'd take poor grammar and interesting ideas over clear grammar devoid of real content any day of the week.

Re:Let's Talk About Writing in Tech by CharlesW on Sunday June 22, 2025 @04:10PM (#44349890)
Assuming that your ability to remember the content isn't a result of differences in the substance of the content, in my experience the stylistic issue can be addressed with thoughtful training/prompting and lots of Do/Don't examples.

It helps if your technical writers already adhere to a voice/tone guide, which can be pretty easily adapted/extended for automated documentation generation. If one doesn't exist, you'll definitely want to create that first. Some good examples:

Google: https://developers.google.com/style

IBM: https://ptgmedia.pearsoncmg.com/images/9780132101301/samplep...

Microsoft: https://learn.microsoft.com/en-us/style-guide/welcome/

Red Hat: https://stylepedia.net/style/

Re:Let's Talk About Writing in Tech by x2tyfi on Sunday June 22, 2025 @03:57PM (#44349800)
That’s understandable - the rule of “garbage in, garbage out” certainly still applies. I find that many engineers are capable of gathering the right requirements and content, but struggle with the polish/finish that makes docs more consumable - where LLMs can shine.