Every now and then, in chat rooms, support channels, and forums, someone shows up and says:
user123: it doesn't work
or maybe,
user123: my code is broken, can anyone help?
This is bad form. What doesn't work? Broken how? What were you expecting to happen? What actually happened instead?
The person asking has all of this context in their head. But the people they're asking have none of it. "It doesn't work" gives helpers nothing to go on. It's like calling a doctor and saying "I feel bad" and expecting a diagnosis.
What the person is really communicating is:
user123: I have a problem but I haven't put in the effort to describe it clearly, so I'd like whoever helps me to figure out what the problem even is before they can begin to solve it.
People who might otherwise help will skip past because there's nothing to grab onto. A vague question turns a five-minute fix into a fifteen-message back-and-forth just to establish what the problem actually is.
Before sending, take a moment to answer:
Here's the same problem, sent properly:
user123: Hey — I'm getting a 403 Forbidden when uploading to my S3 bucket. The bucket is public and my IAM role has s3:PutObject. Here's the full error: AccessDenied: Access Denied at Request.extractError (...) I've checked the bucket policy and it looks right to me. Has anyone run into this?
This takes two minutes to write and makes it much more likely someone can help you — often without needing to ask a single follow-up.
If something looks wrong visually, attach a screenshot. Don't describe it as "the button looks weird" when you can just show it.
If there's an error message, paste the full text. Not "it says something about null." The exact message, verbatim. Error messages exist precisely so people can read them and help you.
When you write a clear, specific question, you respect other people's time — and you're far more likely to get a fast, useful answer.
So before you hit send: describe the problem as if you're explaining it to someone who has never seen your screen and has no idea what you're working on. Because that's exactly who you're asking.