How should I provide feedback about errors in a KB article?

This question is in reference to Atlassian Documentation: How to Re-Index JIRA Data Center without Downtime

Atlassian KB writers - now that comments have been disabled, how do we tell you when we see problems in a KB page? These could be grammatical or technical problems.

1 answer

1 accepted

1 vote

Hi Matt,


Thanks for reaching out about this issue, I'm glad to see you're both interested in the health of our knowledge base and are wishing to provide feedback to it as you always have. 

As you've noticed, the product knowledge base spaces have recently been converted over to using the Confluence viewport plugin. Our official documentation was converted over to viewports sometime last year so this was a move towards consistency of look, feel, and experience for our customers. Part of that work included removing the comments from pages also.

Background aside, you can see that we have implemented two points of feedback. One being the Was This Helpful survey, and the other the integration. As you've likely noted, unfortunately neither of these are the best way raise a problem with the KB solution which leaves us currently without a good way to receive these valuable insights from customers. It is something that we wish to be looking into improving and I thank you for voicing your opinion on the matter.

As an alternative for now, if you see an issue with one of our KB articles we'd ask for you to raise a support issue on support.atlassian.comoffering the URL of the KB, the sentence/s that need work, and what needs to be fixed with them. In the meantime as a short term solution I'll try to make this process more transparent through our "Getting help" pages.



Michael Andreacchio

Atlassian Knowledge Manager

I have to say that the handful of documentation issues I've raised with have all been fixed or improved really quickly.  I'd like to see a dedicated support request type for it though, if that's going to become the official way to do it.

It's great to hear that our support team do their best to help fix these types of problems as quickly as they can. Thanks for the suggestion, I'll be looking into options that are as easy and frictionless as possible, though if we do route customers to support.atlassian.comthen having a dedicated request type is certainly an option.

Thanks, Michael. I quite understand why comments were removed. They're hard to monitor, track progress and close. The use of aac is ok for general questions or feedback, but not so good for specific corrections. A JAC project or issue type seems like a useful approach to me.

Whatever you and the team choose, I'd like to be able to figure out what the current, approved process is.  

Thanks Matt, the current approved process is to log problems with KBs on and a support engineer will take care of the rest. I acknowledge that this process isn't a perfect experience for our customers and will be seeking to improve it if possible. There will be an update if/when this happens.

There is no clear category to submit a support request for documentation changes. I'm presuming if the documentation is about JIRA I should raise a JIRA support request? But some of the articles are about Atlasssian apps in general. So it is not obvious what category to use in that case.

This post is the only information I can find right now about how to submit feedback about documentation and it is a response to a question rather than unprompted information.

It is then, that a reasonable amount of prodding and digging has to be done then in order to provide feedback on documentation.

It seems counter to be requesting support in order to report a problem.

Seems I can report a problem (that is raise an issue) about the product but not the product documentation, which is odd to me.


It would be helpful if KB articles could be linked to community articles that have a very relevant connection like the following KB article and community article.

This could be a part of community feedback, as an extension for to issues and further explanation.

Suggest an answer

Log in or Join to answer
Community showcase
Alexey Matveev
Published Saturday in Jira

How to run Jira in a docker container

Everything below is tested on Ubuntu 17.10. I prefer to use Jira in a docker container because: 1. I can install Jira with a couple of commands. 2. I can start and stop Jira just by starting and s...

83 views 2 4
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot