DocumentaciónHelp

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

  1. Go to Knowledge.

  2. 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

  1. Open the page from the To review tab.

  2. Read it all and compare it with reality: do the steps still work? Did any system, menu or name change?

  3. Look at its Comments: someone may have already flagged what's wrong.

  4. 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

Search Elion ITSM

Type at least 2 characters to search Elion ITSM.

↑↓ to navigate · Enter to open · Esc to close