Review pending pages
Use the To review tab to keep the knowledge base up to date, with pages that are overdue, poorly rated or unused.
On this page
An outdated article does more harm than no article: it leads people to follow steps that no longer work. The To review tab gathers the published pages worth looking at again, so the team reviews them before they cause problems.
Before you start
The tab only shows pages from spaces where you can edit. If you can only read, you'll see it empty.
Open the inbox
Go to Knowledge.
Open the To review tab. Its number shows how many pages there are, and it's highlighted if there are any.
The table shows the Page (title and number), the Space, the Reason and the Review on date. Press the title to open the page. If there's nothing pending, you'll see Nothing pending review.
The reasons
Each page appears only once, with the most urgent reason. The list is sorted in this same order:
Reason | When it appears |
|---|---|
Review overdue | Its Review on date has passed. |
Review due soon | Its Review on date arrives in the next 14 days. |
Lowest rated | It has at least 3 "No" answers to Was this article helpful? and more "No" than "Yes" (see Comments and ratings). |
Unused for 180 days | No one has changed it or linked it to a ticket in the last 180 days. Views don't count. |
Only published pages are included: drafts and archived pages don't appear.
Owner and review date
At the bottom of each page, the details show:
Owner: the person in charge of keeping it up to date. It's the person who created the page.
Review on: the date it's worth reviewing. It's set one year after its first publication. If it has passed, it's highlighted with the word overdue.
For now, the Owner and the Review on date can't be changed from the page screen.
How to review a page
Open the page from the To review tab.
Read it all and compare it with reality: do the steps still work? Did any system, menu or name change?
Look at its Comments: someone may have already flagged what's wrong.
Depending on what you find:
If it needs fixing, press Edit, make the changes and publish it with a Change note saying what you reviewed (see Publish a page).
If it no longer applies, archive it (see Move, archive and delete pages). It leaves the inbox right away.
If it's fine, leave it as is.
When a page leaves the inbox
Unused for 180 days: it leaves as soon as someone saves or publishes a change on the page, or links it to a ticket.
Lowest rated: it leaves when "Yes" answers equal or exceed "No" answers. Fixing the article helps new readers answer yes.
Review overdue and Review due soon: they depend only on the Review on date, which publishing doesn't change. Since that date can't be adjusted from the screen yet, the page stays in the inbox even if you reviewed it.
Any reason: the page leaves if you archive it.
Split the inbox across the team: have each owner review their own pages once a month. That way the list never grows too much.
Related
Reports: the Most used articles report shows how much each article is used and how helpful it is