Posts that do not answer the support template will now be deleted and the user will be blocked

ParanoidShiba · 2023-11-11T08:04:46.838Z

It does seem extreme, to allow no mistakes, getting deleted and blocked, without any chance to correct the mistake. I would ask for at least another chance to get it right. Though I feel for the background that led to this decision.

I agree with this less extreme solution:

Wimvan:

An incomplete support request is answered with a standard text that refers to the requirements that must be met. After this message, the thread is closed.

Would the message deletion and user blocking be automated? If so, maybe the above could be automated, too? Or semi-automated.

laurent · 2023-11-11T13:23:39.094Z

Thanks for the feedback on this change. I see it might not be the best way to address this issue so I've removed it from the template. A good solution would indeed be some sort of automation where a post that doesn't answer the template is deleted, and a PM is automatically sent to the user. I'll see if that can be done.

laurent · 2023-11-11T13:48:54.407Z

Turns out Discourse recently added an experimental form feature so I've implemented it for the support tickets. It's now required to provide at least the version and operating system and hopefully the provided upload fields will be an incentive to provide screenshots and logs (although those are optional).

image1350×1512 151 KB

I assume GitHub has bots to handle template validation so I'll look into this too.

dpoulton · 2023-11-11T14:18:03.369Z

Initial thought from the above layout is that it is not clear if "Version" is asking for the OS version for the previous dropdown (which only has generic options) or the Joplin version.

graphit0 · 2023-11-11T15:41:50.648Z

Would be great to have a nonrequired field asking to confirm that the person tried to use search to resolve their problem

For example

I have used the search function to see if someone else has already submitted the same problem.

No [default]
Yes

Wimvan · 2023-11-11T15:43:30.016Z

I like this option! It may have the potential to serve both sides. Just an idea: Maybe a short introductional sentence could help, á la „the more info you deliver, the better/faster you can expect helpful amswers“ or to just quote the first post from Laurent here:

laurent:

We are always keen to help with support requests, however we often cannot do anything if no information is provided, such as version number, OS, sync target, etc.

whitewall · 2023-11-11T21:01:12.672Z

For this field:

it's not going to be clear to newbies what x.y.z means. I recommend to have the text say

For example: 2.13.3

This is a small quibble, but in the About dialog, it has this:

There is actually nothing labeling the version number as such. Why not put the version number in its own line above Client ID. Like

Version: 2.13.3 (prod, win32)
Client ID: 55ce0b2fbc8e4c0c8c573a6923b41b59
Sync Version: 3
Profile Version: 43

If you are going to be so drastic in requiring information (which is not unreasonable) I think you need to make it as easy as possible for folks to give it. Remember, this may be the very first support request someone has ever made in their entire life.

The first line on the right is kind of superfluous now. And especially the here in the green box doesn't make sense.

But in any case, neither the line on the right or the text in the blue box on the left tells you how to do that. I recommend saying something like "On the desktop app go to Help > About Joplin and then click Copy

2023-11-12 09_53_01-1901×616 74.8 KB

And now that you have dropdowns, I recommend removing the bullet points on the right dealing with sync, editor, and system. No need for it and the more unnecessary things you have, the less people will read the important things.

Also, make sure that a brand new, first time user has permissions to upload files. I know that Discourse severely limits new users as to what they can do and I wouldn't be surprised if this was blocked.

Thanks so much for all you are doing, both with the app and the forum!

laurent · 2023-11-11T22:19:07.243Z

Thanks for the suggestions, I've implemented some of them.

I'm not sure why the text on the right was showing up for you, it wasn't for me, but anyway I've cleared it now so it should only be the form.

whitewall:

I recommend saying something like "On the desktop app go to Help > About Joplin and then click Copy

I thought about that but it's different on macOS, and hopefully users know where the About box is depending on their operating system.

whitewall:

Also, make sure that a brand new, first time user has permissions to upload files. I know that Discourse severely limits new users as to what they can do and I wouldn't be surprised if this was blocked.

The settings have been fine tuned over time to allow as much as possible for new users while restricting spam as much as possible. It's a fine balance to find. What annoys me the most is that we can't allow links by new users because we immediately get a lot more spam.

whitewall · 2023-11-11T22:50:53.148Z

laurent:

but it's different on macOS,

Huh. Today I Learned.

laurent:

What annoys me the most is that we can't allow links by new users because we immediately get a lot more spam.

I don't think we as non-moderators can appreciate all the spam that you get. Thanks for your hard work.

I just remember a while ago I joined a Discourse based forum to post a support question. I gave lots of details and screen shots only to be auto rejected because as a new member I wasn't allowed to include more than 3 screen shots. Frustrating.

I don't know if it matters, but maybe include an "I'm not sure" under the editor drop down. It would avoid the situation where the user just picked one hoping they were correct. Of course you can't prevent all bad things, but maybe it might help.

Thanks again! The form is really nifty.

BTW, I don't see the text on the right now.

Herve5 · 2023-11-13T09:59:50.178Z

I think, in a forum such as ours, there are two very different kinds of people answering new users' posts.

There are the ordinary crowd, like me, that is able to repeat simple tricks ('you didn't RTFM, but do this, it'll solve your issue')

And there are, too, the 'bosses', the very authors themselves, saturated with the ongoing evolution of Joplin and in search of real bugs -but not time wasters like ha, you killed one instance without leaving it delete its lock file, so you must reach that folder in your archive and delete it manually -posted for the 100th time.

This double capacity makes all the huge interest of this forum. In order to help the 'bosses' filter better while not banning newcomers, I think a clear sentence, in the template, could announce something like
if you do not fill up this template correctly, it will NOT be taken into account by the actual Joplin team and only your fellow onlookers may react : to get an in-depth reply by a dev PLEASE fill up the template!

ParanoidShiba · 2023-11-13T11:11:26.875Z

Thank you to laurent for taking our comments in to consideration.
Definitely appreciate the effort that it takes to go through the rubbish.

I had been thinking about what we as users could do to reduce the pain.
Hopefully I can help by trying to answer simple questions in the forum, whenever I can.

laurent · 2023-11-13T11:57:26.589Z

dpoulton:

Initial thought from the above layout is that it is not clear if "Version" is asking for the OS version for the previous dropdown (which only has generic options) or the Joplin version.

I changed it to "Application version" but looks like it's still not enough:

(That's on GitHub, where we can't validate the version number)

I will try "Joplin Application Version" and see if that helps.

ParanoidShiba · 2023-11-13T12:04:47.501Z

Oh dear. Of course you would be frustrated...
Maybe add examples?
Something like

Operating system (e.g. Windows 10, MacOS)

Joplin application version (e.g. 2.13.2)

laurent · 2023-11-13T12:18:55.879Z

Yes that should be clearer now:

image922×316 13.9 KB

dpoulton · 2023-11-13T13:02:47.078Z

Form design is difficult!!

It is especially hard for someone intimately familiar with a project / system to view a form "using the eyes" of a person who has little to no experience of it...

laurent · 2023-11-13T13:50:46.014Z

dpoulton:

Yes I saw that one too. I'll see to improve this as well

whitewall · 2023-11-13T18:10:51.545Z

Maybe

For Desktop Application: paste "About Joplin" information below

Non technical users won't know what "dialog" means. And perhaps by putting "About Joplin" in quotations it hints at the fact that this is a specific thing?

It would be great if the form was able to include real links.

Yajo · 2023-11-14T11:50:02.628Z

You can add a button in Joplin that opens the issue form pre-filled, just like vscode does.

IanHinton · 2023-11-20T21:18:07.649Z

How about an autoresponder that detects if the template is not complete and replies with "Template not completed, your email will be deleted. IF you want support, fill in the template completely".

Wimvan · 2023-11-21T06:41:14.867Z

The text is confusing to me. I’d like to change „your email“ into “your enquiry” in your sentence.
Instead of deletion, would it be an alternative solution to

a) say: “Template not completed, Your support enquiry will therefore most likely not be answered. IF you want support, fill in the template completely" AND

b) label the request as incomplete (so every reader in the forum can read it but directly sees the “incomplete-flag”?

So you can ignore threads arising with an incomplete flag, but if anyone else wants to volunteer, he/she can.