Skip to main content
added 524 characters in body
Source Link
user3458
user3458

I think the first goal for the wizard should be to satisfy the user's need for help before they post the question. Failing that, the wizard should extract enough information from the user to prepare a decent help-me question.

The first goal obviously cannot be satisfies with simple text search, as SO already does that.

So I propose to extract more structured information out of the user - information that allows for more targeted help, better matching of the user's situation to the existing SO knowledge.

Here is what I would suggest, in the form of some examples

Top Level

  1. My program is not working.
  2. I don't understand why this code works.
  3. What is the meaning of this code?
  4. Other

1. "My program is not working."

What language is your program written in?

1.1 C++

1.1 C

1.2 Java

1.3 JavaScript

1.4 Python

1.5 C#

1.6 Other

1.1 C++

Do you have

1.1.1 Compiler error (explain)

1.1.2 Linker error (explain)

1.1.3 The code does not print what I want it to print

1.1.4 Runtime error (explain exception, aborts, memory corruption)

1.1.3 Output of the code does not match the expected output

1.1.3.1 Please try using the debugger (ask for environment, explain how to use debugger)

1.1.3.2 Please provide the following

Exact code you're running (explain MCVE, limit the amount of code accepted, possibly use one of online compiler sites to verify) The exact output (explain copy/paste) The expected output

1.1.4 Runtime error

Please provide the exact text of the error

Perform a search on canonical questions for C++ runtime errors, present answers. If none fit, proceed as for 1.1.3

1.2 Java

1.2.1 Syntax error

1.2.2 Runtime error

1.2.3 Exception thrown

1.2.3 The code does the wrong thing

1.2.3 Exception thrown What is the exception (explain how to get both the message and the stack trace) Perform a search for canonical Java Exception questions

1.2.3.1 NPE 1.2.3.2 ClassNotFound ...

1.2.3.1 NPE

Explain how to analyse the line where NPE was thrown (notNull.call()) Explain how to track the null through the code If help is still needed, proceed with collecting the Java MCVE

Here is what I would suggest, in the form of some examples

Top Level

  1. My program is not working.
  2. I don't understand why this code works.
  3. What is the meaning of this code?
  4. Other

1. "My program is not working."

What language is your program written in?

1.1 C++

1.1 C

1.2 Java

1.3 JavaScript

1.4 Python

1.5 C#

1.6 Other

1.1 C++

Do you have

1.1.1 Compiler error (explain)

1.1.2 Linker error (explain)

1.1.3 The code does not print what I want it to print

1.1.4 Runtime error (explain exception, aborts, memory corruption)

1.1.3 Output of the code does not match the expected output

1.1.3.1 Please try using the debugger (ask for environment, explain how to use debugger)

1.1.3.2 Please provide the following

Exact code you're running (explain MCVE, limit the amount of code accepted, possibly use one of online compiler sites to verify) The exact output (explain copy/paste) The expected output

1.1.4 Runtime error

Please provide the exact text of the error

Perform a search on canonical questions for C++ runtime errors, present answers. If none fit, proceed as for 1.1.3

1.2 Java

1.2.1 Syntax error

1.2.2 Runtime error

1.2.3 Exception thrown

1.2.3 The code does the wrong thing

1.2.3 Exception thrown What is the exception (explain how to get both the message and the stack trace) Perform a search for canonical Java Exception questions

1.2.3.1 NPE 1.2.3.2 ClassNotFound ...

1.2.3.1 NPE

Explain how to analyse the line where NPE was thrown (notNull.call()) Explain how to track the null through the code If help is still needed, proceed with collecting the Java MCVE

I think the first goal for the wizard should be to satisfy the user's need for help before they post the question. Failing that, the wizard should extract enough information from the user to prepare a decent help-me question.

The first goal obviously cannot be satisfies with simple text search, as SO already does that.

So I propose to extract more structured information out of the user - information that allows for more targeted help, better matching of the user's situation to the existing SO knowledge.

Here is what I would suggest, in the form of some examples

Top Level

  1. My program is not working.
  2. I don't understand why this code works.
  3. What is the meaning of this code?
  4. Other

1. "My program is not working."

What language is your program written in?

1.1 C++

1.1 C

1.2 Java

1.3 JavaScript

1.4 Python

1.5 C#

1.6 Other

1.1 C++

Do you have

1.1.1 Compiler error (explain)

1.1.2 Linker error (explain)

1.1.3 The code does not print what I want it to print

1.1.4 Runtime error (explain exception, aborts, memory corruption)

1.1.3 Output of the code does not match the expected output

1.1.3.1 Please try using the debugger (ask for environment, explain how to use debugger)

1.1.3.2 Please provide the following

Exact code you're running (explain MCVE, limit the amount of code accepted, possibly use one of online compiler sites to verify) The exact output (explain copy/paste) The expected output

1.1.4 Runtime error

Please provide the exact text of the error

Perform a search on canonical questions for C++ runtime errors, present answers. If none fit, proceed as for 1.1.3

1.2 Java

1.2.1 Syntax error

1.2.2 Runtime error

1.2.3 Exception thrown

1.2.3 The code does the wrong thing

1.2.3 Exception thrown What is the exception (explain how to get both the message and the stack trace) Perform a search for canonical Java Exception questions

1.2.3.1 NPE 1.2.3.2 ClassNotFound ...

1.2.3.1 NPE

Explain how to analyse the line where NPE was thrown (notNull.call()) Explain how to track the null through the code If help is still needed, proceed with collecting the Java MCVE

Source Link
user3458
user3458

Here is what I would suggest, in the form of some examples

Top Level

  1. My program is not working.
  2. I don't understand why this code works.
  3. What is the meaning of this code?
  4. Other

1. "My program is not working."

What language is your program written in?

1.1 C++

1.1 C

1.2 Java

1.3 JavaScript

1.4 Python

1.5 C#

1.6 Other

1.1 C++

Do you have

1.1.1 Compiler error (explain)

1.1.2 Linker error (explain)

1.1.3 The code does not print what I want it to print

1.1.4 Runtime error (explain exception, aborts, memory corruption)

1.1.3 Output of the code does not match the expected output

1.1.3.1 Please try using the debugger (ask for environment, explain how to use debugger)

1.1.3.2 Please provide the following

Exact code you're running (explain MCVE, limit the amount of code accepted, possibly use one of online compiler sites to verify) The exact output (explain copy/paste) The expected output

1.1.4 Runtime error

Please provide the exact text of the error

Perform a search on canonical questions for C++ runtime errors, present answers. If none fit, proceed as for 1.1.3

1.2 Java

1.2.1 Syntax error

1.2.2 Runtime error

1.2.3 Exception thrown

1.2.3 The code does the wrong thing

1.2.3 Exception thrown What is the exception (explain how to get both the message and the stack trace) Perform a search for canonical Java Exception questions

1.2.3.1 NPE 1.2.3.2 ClassNotFound ...

1.2.3.1 NPE

Explain how to analyse the line where NPE was thrown (notNull.call()) Explain how to track the null through the code If help is still needed, proceed with collecting the Java MCVE