Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

If you want to humanize the documentation, introduce actual characters. "Here's Bob. Bob wants to update his widgets." Don't pretend that stereo instructions can be made to read like Elmore Leonard stories simply by changing pronouns.

At the point where you start synthesizing vibrant life stories out of gendered pronouns with "the user" as antecedent, you might consider instead just conceding the argument.



Consider applying for YC's Summer 2026 batch! Applications are open till May 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: