Best practices: gathering user feedback for published support articles / Jira Issue Collector

Question

Howdy,

We are maintaining a knowledge base and would like to collect user feedback. The idea is to let people specify if a specific article was useful for them or not. And, if they answer 'not useful', let them suggest an improvement of change.

What would be the best practices to implement this in Confluence? I would appreciate any suggestion. Any macro or plugin? Also, is it possible to implement using external services without having to install any plugins for Confuence?

Jira Issue Collector

Participating in one of the AUG meetings I remember hearing about Conlfuence Jira Collector macro, which if my mind serves me well, should handle this all quick and easy. I have found this video, but I don't think I caught everything right. Would I be able to use this macro in Confluence?

Those of you who are already using this macro, please leave your feedback, I'd appreaciate your input.

Thank you in advance.

Irina_Bel_Stiltsoft_ · Answer

Hi @Stan Ry ,

In Stilsoft, we collect customers' feedback with our Customer Case for Jira app(far less expensive than Jira Service Management and without sites, users, and agents limit). You create a portal for your external clients to submit their issues or ideas. It can be public (visible for everybody), private (restricted for specific email addresses or domains), or you can choose the option to make it a support service (personal communication with support assistant). The public portal where clients vote for ideas helps us prioritize our backlog.

I can show you how to create a portal for your project and answer your questions if you get interested.

Stan Ry · Answer

Hi @Sloan N_ B_, Thanks for your response. Dear Niklas, could you please specify, what would be the best way to integrate the form, which appears when you click the trigger, right into the page? I'd like to have the form shown at the bottom of my pages, or better have a button somewhere on article page that, when clicked, shows the feedback form underneath without poping it out for the users. Currently I see the following code: What would be the proper way to call this from a button? I am currently using the approach published in Advanced use of the JIRA issue collector: 1. I have added Markdown macro to the page. 2. Then I have inserted the following code inside the Markdown macro

JIRA Issue Collector Demo

Report feedback However, when I click the Report feedback button, nothing happens. I have also copied the following code to a HTML file to test it out:

JIRA Issue Collector Demo

Report feedback
Report bug Again, nothing happens when I click either of the buttons. What am I doing wrong? Thank you.

Sloan N_ B_ · Answer

Hi Stan Ry

The Jira issue Collector is not a Confluence Macro, but a widget you can implement in any website and web application allowing you to implement HTML. Since there are HTML macros in confluence, this would work. :)

Using it as feedback platform in confluence is a nice Idea if you already use Jira.

Here is Atlassian's Documentation on the Issue Collector, and here is the Documentation on the HTML Include Macro.

Regards
Nick