Hi, I run https://discourse.bokeh.org and also frequent https://discuss.python.org often. In both places, there is a pretty terrible issue with new users not formatting code in their first posts. There are typically several posts per day on the main Python forum where users need to be corrected. [1] This is huge, constant drain on many people’s time.
Would it be possible to have mandatory onboarding flows, before a new users is allowed to make a first post? I am thinking explicitly of a flow where the user is presented with how to accomplish code formatting, and then is tasked with manually reproducing 2-3 lines of formatted code. They have to complete this successfully before being allowed to post.
This is an especially pernicious problem for Python, since indentation is significant. ↩︎
One thing that mandatory onboarding would help with is screenshots with code in them, although OCR could presumably be used to print a warning on such posts like the existing “Unformatted code detector” plugin.
I don’t follow Bokeh, so I can’t judge if the plugin is working well or not.
Actually, the unformatted code detector plugin is enabled on discuss.python.org. I looked at the Users category of that forum (I haven’t followed this category recently), and to be fair, it looks much better than it used to be, although there are still a few posts with unformatted code.
FWIW here is an example today with a large block of code (that should pass any threshold) that the plugin did not catch:
which then prompted an offshoot discussion about just this onboarding / code-formatting topic, which the OP seemed to take some offense to.
Is the plugin just broken, or needs an update? Regardless, I do still think a mandatory “format this code” challenge before being allowed to post is a valuable addition to “auto-detection”.
should it be a bit more coercive ? maybe
an easy first step could be a little tweak of the text of the button, maybe submit could be BEWARE !!! or something like that…