So the new welcome wagon rolled in and brought us more examples of comments considered "not welcoming". While I did participate in the survey and found a few comments that I found not welcoming, I really wonder about the examples given this time.
“Why do you want to do this? You have conflated at least three problems here.”
Seems a legitimate question. If I don't know why someone wants to do something, I cannot solve the mess. I cannot detect any unwelcoming tendencies.
“It will be very hard to help you with such a trivial bug. It could come from any line in your code, and we have to guess.”
This is not very constructive. There is not positive path forward, no way to answer or edit to improve this. So yeah... I can see it.
“How exactly is this going to solve my problem?!”
Personally, I tend to perceive this as unwelcoming because of the "?!" and the tone it implies in my head. On the other hand side, people agree that a question mark is not necessary and maybe not known to be required in a question, so what is it, do we care for punctuation to the dot, or do we say "ah, whatever, as long as it's readable". Because right now we seem to do both and neither is improving quality.
“You don’t understand how to use this site. Here nobody codes for you; read the docs and then show us.”
True. Maybe a bit too direct. But at least it does show a way forward. How nice do we want people to be and what level of language does that imply? We seem to say that the direct truth without niceties is below the bar, yet we want to be friendly to people who are not native speakers. So what is it, do they need to be able to express the pleasantries that we require to be nice, or do we require only enough skills to communicate their programming problem properly?
“What are you actually trying to achieve? Please learn how to use a debugger.”
See #1. "Why are you doing this" and "What is your goal" are perfectly valid questions to solve a problem. "Please learn how to use a debugger" is good advice.
So I guess my question is... how could those comments have been improved? How should they have been written?