News for hackers. Stuff that matters.
Re:Just Simply – Stop saying how simple things are in our docs by spondylosaurus on Sunday April 30, 2023 @02:52PM (#35765458)
This advice extends far beyond free libraries (and the linked article makes no indication that it's specific to that context). I've encounter all kinds of B2B SaaS docs full of worthless bloat, and I've written docs in the face of pressure from product teams who want to turn documentation into a Look How Cool We Are showcase.

And docs can be clear and straightforward without reading like stereo instructions—you can convey plenty of personality through tone and voice.

There are no comments on this comment yet.