Skip to main content
Commonmark migration
Source Link

enter image description here


Help us to help you

##Help us to help you WeWe don't know anything about your problem, please explain it carefully.

What is wrong?

##What is wrong? InIn the title of your question, try to tell us what the problem is.

Examples: Examples of good/bad titles

What are you trying to do?

##What are you trying to do? InIn the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples: Examples of good/bad code

##Work on your code

Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

Help us to help you

##Help us to help you IfIf people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

enter image description here


##Help us to help you We don't know anything about your problem, please explain it carefully.

##What is wrong? In the title of your question, try to tell us what the problem is.

Examples: Examples of good/bad titles

##What are you trying to do? In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples: Examples of good/bad code

##Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

##Help us to help you If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

enter image description here


Help us to help you

We don't know anything about your problem, please explain it carefully.

What is wrong?

In the title of your question, try to tell us what the problem is.

Examples: Examples of good/bad titles

What are you trying to do?

In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples: Examples of good/bad code

Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

Help us to help you

If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

Made it usable for sending users to
Source Link
Benjol
  • 66.4k
  • 2
  • 24
  • 28

enter image description here

I initially wondered about a sort of step-by-step wizard (which would have the advantage of guiding the user, and also breaking down the long text into manageable chunks), from there I moved on to the following text, where my main aims were brevity, and simple English. I think that SSCCE puts too much accent on just the code, which (in my opinion) is too limiting. We can't expect people to read "How to ask a good question" AND SSCCE AND etc.... So here I take a step back.

To make it even shorter, the example sections could be collapsed by default.


##Help us to help you We don't know anything about your problem, please explain it carefully.

##What is wrong? In the title of your question, try to tell us what the problem is.

Examples: Examples of good/bad titles

Bad : C# not doing what I want

Good : Why does using float instead of int give me different results when all of my inputs are integers?

##What are you trying to do? In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples: Examples of good/bad code

Bad: This is not working:

double Divide(int x, int y) 
{
    return x / y;
}

Good: I have a function to divide two numbers. If I call Divide(3, 2), I expect it to return 1.5, and instead I get 1.

double Divide(int x, int y) 
{
    return x / y;
}

##Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

##Help us to help you If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

enter image description here

I initially wondered about a sort of step-by-step wizard (which would have the advantage of guiding the user, and also breaking down the long text into manageable chunks), from there I moved on to the following text, where my main aims were brevity, and simple English. I think that SSCCE puts too much accent on just the code, which (in my opinion) is too limiting. We can't expect people to read "How to ask a good question" AND SSCCE AND etc.... So here I take a step back.

To make it even shorter, the example sections could be collapsed by default.


##Help us to help you We don't know anything about your problem, please explain it carefully.

##What is wrong? In the title of your question, try to tell us what the problem is.

Examples:

Bad : C# not doing what I want

Good : Why does using float instead of int give me different results when all of my inputs are integers?

##What are you trying to do? In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples:

Bad: This is not working:

double Divide(int x, int y) 
{
    return x / y;
}

Good: I have a function to divide two numbers. If I call Divide(3, 2), I expect it to return 1.5, and instead I get 1.

double Divide(int x, int y) 
{
    return x / y;
}

##Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

##Help us to help you If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

enter image description here


##Help us to help you We don't know anything about your problem, please explain it carefully.

##What is wrong? In the title of your question, try to tell us what the problem is.

Examples: Examples of good/bad titles

##What are you trying to do? In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples: Examples of good/bad code

##Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

##Help us to help you If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.

Post Migrated Here from meta.stackexchange.com (revisions)
Source Link
Benjol
  • 66.4k
  • 2
  • 24
  • 28

enter image description here

I initially wondered about a sort of step-by-step wizard (which would have the advantage of guiding the user, and also breaking down the long text into manageable chunks), from there I moved on to the following text, where my main aims were brevity, and simple English. I think that SSCCE puts too much accent on just the code, which (in my opinion) is too limiting. We can't expect people to read "How to ask a good question" AND SSCCE AND etc.... So here I take a step back.

To make it even shorter, the example sections could be collapsed by default.


##Help us to help you We don't know anything about your problem, please explain it carefully.

##What is wrong? In the title of your question, try to tell us what the problem is.

Examples:

Bad : C# not doing what I want

Good : Why does using float instead of int give me different results when all of my inputs are integers?

##What are you trying to do? In the text of your question, before any code, start by telling us what you want your code to do, then tell us what is going wrong (for example, any error messages).

Examples:

Bad: This is not working:

double Divide(int x, int y) 
{
    return x / y;
}

Good: I have a function to divide two numbers. If I call Divide(3, 2), I expect it to return 1.5, and instead I get 1.

double Divide(int x, int y) 
{
    return x / y;
}

##Work on your code

If you can, try and reduce your code sample so that it only shows the part where the problem is. If you already have an idea where the problem is, try to write a small code sample that shows just the problem. If you don't know, you can try to find it by removing bits of code until the problem disappears.

This is hard, but if there is less to read, more people will look at your question.

##Help us to help you If people ask you for more information in comments, answer them. You can also update your question to make it easier to understand. Other people may also modify your question: they are trying to help.