News for hackers. Stuff that matters.

A comment on Just Simply – Stop saying how simple things are in our docs. Parent comment

Re:Just Simply – Stop saying how simple things are in our docs by yellowapple on Sunday April 30, 2023 @12:46PM (#35764296)
> the tone of the "just simply" writing comes off as condescending because it implies the author is considerably more knowledgeable than the reader

If the author of some library was not considerably more knowledgeable than myself, then I probably wouldn't be poring over said library's documentation.

[ Parent | on HN ]
Re:Just Simply – Stop saying how simple things are in our docs by jjj123 on Sunday April 30, 2023 @09:42PM (#35768290)
But they are writing for an audience that is not as knowledgeable, so “simply” isn’t accurate for the audience, only the writer.
[ Parent | on HN ]
Re:Just Simply – Stop saying how simple things are in our docs by cratermoon on Sunday April 30, 2023 @09:47PM (#35768316)
Yes, the author of that library knows more about that library. That doesn't mean they are generally more knowledgeable than me, and in fact they may be quite ignorant about the specific problem that lead me to investigate and learn the library in the first place.
[ Parent | on HN ]