It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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
Answer accepted

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 Sign up to answer

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you