Read docs feedback
See which help and documentation pages readers found helpful or not, read their comments and find the pages that need work first.
At the bottom of each help article and documentation page, readers are asked whether the page helped, with a Yes and a No button and an optional comment. The platform Docs feedback screen collects these answers. The platform team uses it to see which pages work and which ones confuse people.
Before you start#
- Your role must be allowed to read platform metrics. If Docs feedback is missing from the menu, ask for that access.
- The answers are anonymous. You see the page, the vote, the comment, the language and the date, but not who sent it.
Step 1: See the summary by page#
- In the platform menu, open Docs feedback.
- Summary by page lists each page with how many readers marked it Helpful and Not helpful.
- Start with the pages that have the most Not helpful votes. They are where readers get stuck.
Step 2: Read the comments#
- Scroll to Comments and votes.
- Each entry shows the Page, the vote, the Comment if the reader wrote one, the Language and the Date.
- Use the vote filter to show only Helpful or only Not helpful answers.
- To look at one page, type part of its address in the filter box, for example the path of a help article.
- Older entries load further down when you ask for more.
Step 3: Act on what you read#
- Note what readers say is missing or wrong.
- Open the page yourself and check it against the app.
- Pass the change to whoever writes the help pages, with the comments that prompted it.
What happens next#
New answers appear as soon as readers send them. After a page is fixed, watch its votes over the following weeks to see whether the share of Not helpful goes down. Comments are short by design, so one comment rarely tells the whole story; look for the same problem coming up more than once.
Common problems#
- No feedback yet. No reader has answered the question on any page yet.
- The list is empty after filtering. The vote filter or the page filter hides everything. Clear both to see all answers.
- Could not load documentation feedback. Reload the page. If it keeps failing, check the system status on Home.
- A comment asks for a reply. Answers are anonymous, so you cannot reply. If it reports a real problem, fix the page.