DEV Community


Discussion on: How to remove condescending language from documentation

moopet profile image
Ben Sinclair • Edited

We're trying to be a friendly, helpful community, and in that light, your comment is not constructive.

I think this is a very useful post. People, myself included, genuinely feel put off when we try to follow documentation that suggests we should be able to do something, and that it's our fault when we fail. It might be our fault, but it might also be down to missing or outdated documentation, and I'm sure you've felt some measure of frustration with scrappy documentation in the past?

Nobody likes to feel like an impostor (to crowbar that word in), but that's sometimes the result of telling people a task is "easy" when it's not.