Recent searches
No recent searches
Internal Commenting/Suggestion Feature on Articles
Posted Aug 14, 2020
Hi ZD team! We would like to see an internal commenting feature added to Zendesk guide articles. It would be something similar to Google Docs or Microsoft Word's ability to add comments to specific paragraphs, sentences, or words.
As a technical writing professional, this is a must-have. It's a huge hassle for our team when we are reviewing articles, as we can't do the reviews in the same place where we write and publish the article. Since Zendesk doesn't offer us any viable options for reviewing articles, we have to use Google Docs to fill in the gaps in this current workflow.
Our current process: We send our articles for review to subject matter experts (SMEs) at least once but sometimes more so that they can review for technical accuracy, but since there are no internal comments for articles, we have to copy and paste into a Google Doc to allow the SME to comment on what sections or lines need to be changed. Then, we can either make changes to the Google doc before passing it to someone on our team to review for grammar and clarity or we change it in Zendesk and then copy and paste the new version to GDoc. During this process, we lose the proper formatting we need in the article.
It doesn't make sense to move content in and out of Zendesk to Google Docs and back to Zendesk. Additionally, it loses a proper "audit log" on the article since the small changes are not properly shown in Zendesk when items are moved in and out. It only shows a large copy/paste of information.
Having the feature implemented into Zendesk would majorly streamline our process.
Thanks,
Katie
35
16
16 comments
Kalle Windefalk
This is a must have in a KCS oriented organization. Now we need to connect a public article with an internal article if the resolution can't be achieved by the end-user. The article subjects will compete in the results when agent search for articles in the KC app.
If there was an internal section, the resolution for the help desk could be written in the public article and the reporting would be more correct.
5
Nicolas Guyomar
Hi ZD team,
That "missing" feature is a major blocker for reviewer adoption in my opinion.
A first step to ease the review process would at the very least to have the comment history accessible from the article, as we only retain the last one ?
Then what Katie explained would be perfect !
Thank you
5
Dan Cooper
Much of our support documentation is highly collaborative and we are still in an adoption phase with some portions of our team. Having the review process restricted to one field without any history makes this process burdensome as we amp up the amount of articles needing review. The suggestion to use commenting like Google Docs is a great one is that it's familiar to many users already who use Google, Microsoft, and Atlasssian products.
Even small changes here could gain large returns. If the assignee field could show a history of what was said and by who, it would go along way in helping keep conversations in perspective until an article can be published. It would also make sense to include in the Guide History events for the particular article.
Having one field without history quickly degrades the experience and an early question I'm hearing is "can another product do this better".
6
Shana Blackstone
The suggestion Katie mentions is one of the reasons we are debating using another tool, such as Confluence, for our Knowledge Base. Internal comments and suggestions would do two things for us:
1. Streamline the create/review process.
2. Train internal customer support reps to give well-educated answers without extensive prior training. This would be game changing.
The biggest miss I have seen with all documentation applications is not supporting customer-facing information and internal-only information in one single document. We use most of our documentation to train customer support reps. We have to maintain two documents. One for the customer, and another that is a copy of the customer-facing doc but with internal notes to educate the support teams as to the "why you would tell the customer this". The "why" is what makes for better customer support. And the "why" doesn't need to clutter up the customer docs.
Neither Google nor Confluence, have this option. Everyone can see the comments. Unfortunately, two docs also mean eventually one gets updated, but the other does not.
This would put you leagues above other KB applications. Add versioning to that and I'd never think of using another product.
5
Daniel Lautersztain
As an org that has just moved our central KBs to Guide, we are also feeling the pain of lacking a robust comment feature-set that supports version history. I'd like to add that other than just internal commenting being paragraph/word specific, not having this for end users is also a pain. We are a feedback heavy company and encourage end users to leave feedback on articles but we wish this could be done by quoting specific sections.
5
Jerry Lopez
When an end user states that an article was not helpful, there is currently not a way to capture any additional feedback other than whether the article was helpful or not. Therefore, it is hard to know what the end user had in mind that would make the article more useful. Having a way to provide feedback would be quite helpful in improving the quality of our content.
5
Joanne Chow
Experiencing the same limitations here. Having to copy and paste from Google Docs due to not being able to view historical comments or mark up parts of an article natively within Zendesk adds additional time to our workflow and increases the possibility of human errors in the process. Can we please have a better reviewing feature built in Zendesk that supports the common content creation process of write > review > edit > review > publish
0
Sharon Burton
These sorts of limitations had us finally move authoring and managing content to Paligo and we publish directly into Zendesk and host the content there. We have full professional review, conditional text for when we publish the same article to different audiences, variables, and so on.
I need to have multiple versions of the same doc for internal and external audiences and I got tired of waiting. I needed a way to find and replace things like vendor names when they changed that didn't require manually touching hundreds of articles. I needed screen shots that could be reused.
Your milage may vary.
1
Joanne Chow
Sharon Burton We have almost the same use case and are also looking into Paligo to overcome this. Sounds like Paligo is serving you well and would serve us well too.
0
Katarzyna Karpinska
Thank you for all your comments, I just wanted to drop a quick update that we hear your need for more collaborative creation of Guide articles. We are in a process of upgrading the editor technology right now and once that's done it'll enable us to deliver on article commenting requests as well as other collaboration-related features.
Sharon Burton, I understand your frustration and I'm happy to hear that the Paligo integration works for you well. Just wanted to let you know that we have recently added image support for content blocks as well as an easy way to quickly replace images from the account-level gallery.
0
Summer Polacek
Hi Katarzyna Karpinska is there any update on this product feature development? We just switched from Atlassian's Confluence literally in the past 3 months, and we sorely miss this collaboration feature - comments is a must. We're already finding ourselves using Google's products to collaborate and then do double work to bring this back over to ZD. We'd be very happy to try anything in Beta. Please?
2
Katarzyna Karpinska
Hi Summer Polacek,
We are still working on the backend of the editors. This work is necessary to enable commenting (and other collaboration features) in Guide. We expect the first customer-facing changes to be released next year.
0
David Monteiro
Same here - we are using a process that puts Google Docs in the middle and it's not great to say the least.
Can't wait for that feature to come in :)
0
Darrel Hamlet
Is there any update on this enhancement request? Having an easy-to-use, integrated document review/comment capability would help us a lot! Thanks.
0
Jakub Raduszewski
Just like Jerry Lopez wrote - having suggestions from HC viewers or private commenting possibility to see the reason of downvotes would be super helpful for our continuous HC improvement.
0
Yaniv Nord
Katarzyna Karpinska Any updates on this since 2023? I was surprised to find today that our enterprise license doesn't allow reviewers to comment inline on guide articles. Was this deprioritized? The alternative for me is to maintain word documents for legal and compliance review, which as you might imagine defeats the purpose of having a web-based knowledge base.
0