A few years ago I built a little tool which guided beginners through constructing a question with an MCVE in Python. I commented on a few poor questions suggesting that they use it. Then I got a moderator message:
We noticed that a substantial proportion of your comments seem to exist only to promote your product.
Be careful, because the community frowns on overt self-promotion and tends to vote it down and flag it as spam. So, please refrain from this behavior in the future.
I replied but got no further response. Not knowing what to do and feeling disillusioned about the general idea, I just dropped the whole thing.
Now as part of a larger project I've built a better version and I want to do things right this time.
Briefly, here's what the question wizard does:
- Ensures that the user provides complete code by actually running it.
- Generates a question with code, output, and expected output, all correctly formatted.
- Provides built-in debuggers, linting, and enhanced tracebacks to help users find the problem themselves.
- Includes an enhanced traceback (when there's an error) in the output in the generated question, showing the values of variables and simple expressions.
- Shows how to replace uses of
input()
(reading from stdin) with literals so that rerunning the code and reproducing the problem is easier for everyone. - Provides general advice and resources.
My questions are:
- Is the wizard itself appropriate for SO? Does it go against some principle of the site? Is there anything I need to change to make it acceptable?
- Is it appropriate for me to recommend the wizard in comments on questions, or will that be considered spam again? Is there an appropriate 'non-spammy' way to phrase comments recommending the wizard? To be clear, this is my project so I'm obviously not impartial, but I get no financial benefit from it and I don't plan to. The benefits to me are basically just self-esteem and reputation.
- Can people other than myself recommend it? Does anyone think they would want to recommend it sometimes?
- Can SO officially link to it the way this page links to the
reprex
package?