During Triage reviews, I'm having difficulty categorizing questions that are generally good, but they have posted their entire script, group of files, etc.
- These are questions where the user needs to be redirected to the help page on how to provide a good
- A further explanation of why "Wall of Code" questions deserve a downvote can be found here:
I believe these are "unsalvageable", because the author is responsible for doing the work required to create a "Minimum, Complete, Reproducible" example so his question is clear in the minimum amount of space, which is good for everyone involved (and, incidentally, he will often solve his own problem in the process).
In addition, many posts tangentially fit this category because they are not reproducible - often because they are missing import statements, header file info, support files, or other configuration settings needed to recreate the error.
i.e. These should not be marked as "requires editing", because it's not the community's job to parse through questions and figure out how to minimize the code. In many cases this can't be done due to reproducibility problems anyway.
Which unsalvagable category to choose?
In trying to choose a flag for these questions, I'm having difficulty choosing the right category. They don't seem to fit - at least the descriptions don't. Here are the options that might fit:
- Unsalvagable
- needs improvement (The question needs updates from the author in order to be answered well...)
- Needs details or clarity
- This question should include more details and clarify the problem.
- Needs more focus
- This question currently includes multiple questions in one. It should focus on one problem only.
- Opinion-based
- This question is likely to be answered with opinions rather than facts and citations. It should be updated so it will lead to fact-based answers.
- Needs details or clarity
- needs improvement (The question needs updates from the author in order to be answered well...)
None of these seem to fit exactly. The question needs refinement, and actually some development effort to narrow the focus and create a set of code that someone else could actually run on their system easily to reproduce the issue, while focusing it down to the one specific error that this question needs to address. It may be missing a few pieces to be reproducible.
I think the "Needs Details or Clarity" category fits the best, but it's often that the problem is clear and there are enough details to answer it, just that the question needs to be refined and focused. But if you look at the description for "Needs more focus", it doesn't seem to fit - i.e. there aren't really multiple questions, it's more that there is extra, unnecessary code that is hiding the key issue.
Is the user getting the right response?
Another key concern here is that, especially for new users, that the response they get clarifies for them that they need to focus their code and go through the (sometimes) hard work of creating the minimum code that still causes the error, while making sure they also include enough context and scaffolding code to make it reproducible.
I can comment on the question directly with a link to that information, but that takes time and slows down my ability (and desire) to run through some triage reviews.
In addition, I'm not sure I'm marking these specific types of questions correctly.
Questions
- Which category should be choosen in the current system for "Wall of code" questions?
- Should the category descriptions be updated to clarify for reviewers which one to pick in this case?
- Or - Should a new category be added specific to this type of problem?