You can find more information on what Topic Templates are in the Discourse documentation, particularly here. For those who are familiar with GitHub issue templates, they functionally serve a similar role.
Given that so much of Neuro Questions traffic concentrates on software use, I think it would make sense to ask for more structured information when users open a post in this category. In particular, I think we can ask for :
The name(s) of the package(s) used
The corresponding version(s)
A short description of the problem
Any other relevant information
I’m sure that much more could be added here, but I think that this is likely minimal enough to be relevant across software projects.
Sounds good as a minimal template, thanks Elizabeth!
I might suggest making “what troubleshooting steps have you already tried?“ part of the minimal set of questions. I might also recommend, since many of the questions resolve around BIDS apps and many problems might be solved by clues in validation, adding something like “If using a BIDS app, are your data BIDS-valid?”. But I recognize this is not relevant for every issue.
BIDS Validity (could generally say “Are your data formatted according to a validatable standard? Please provide the output of the validator.”)
Relevant log outputs (maybe prompt for 20 lines)
Screenshots / relevant information
Unfortunately, I find that GitHub templates are very frequently ignored. The forms with required fields have made things much better, but a determined user can still avoid giving useful feedback.
I’m also a bit concerned about doing this for “Neuro Questions” which is supposed to be for “any and all questions about Neuroscience”, which goes beyond software support, and I don’t want to show people this and make them feel that their non-software question is out-of-place. If we do want to make a template like this, I think we should make a new category and start closing software support posts in NQ and redirect them to the new category.
To your point on the scope of the template, @effigies :
I agree that the Neuro Questions category is loosely scoped, but I think (from my review of postings, though I’d love to hear if others disagree) that folks have naturally converged into a few key use cases, the primary of which seems to be software support.
Since these are optional fields (i.e., not enforced when the user creates a new post, just pre-supplied), maybe we could add a short blurb at the top of the template stating that these fields are intended for software support and can be ignored otherwise ?
thanks everyone for this important discussion and your great points.
From my end, basically +1 re everything.
I very much agree with this and wondered if there’s an option to make folks more aware of this, ie why useful feedback is especially important for them, eg. in order to get their questions answered. Maybe the required fields could be expanded with a little note at the beginning/end a la “Could you please make sure that all information, required to address your question sufficiently, is provided?”. I’m not sure if this would actually do something but sometimes a reminder here and there does the trick (at least in my case, hehe).
I’m very sorry if I missed this but couldn’t there be different templates for different categories?
It sounds like the first step is to figure out a potential name for a new, software support only category. Suggestions ? Is “Software Support” too straightforward ?
I’m having some trouble figuring out how to highlight categories on Discourse beyond re-ordering them on the homepage – at least with the default Discourse configuration.
I do think we could re-organize the current categories to better effect, though; for example, the ABCD ReproNim, Neurohackademy, and Neuromatch Academy categories are all above Site Feedback, even though they’re not currently active.