1 Approvals

Knowledge base articles can be written as drafts and then approved as a stable version. This feature can be activated on a namespace level.

1.1. Activating the approval feature

To activate the approval feature (admin rights are required):

1. Click Global actions > Management > Namespaces.
2. Select the edit-action for a namespace by clicking the wrench symbol in the Actions column of the selected row.
3. Activate the approval checkbox.
4. Click Done.
   

Activate the Approval feature

1.1.1. Existing pages

After activating Approvals for a namespace, all articles in the namespace are set into first draft mode.

Frist draft

1.1.2. New pages

When a new page is created and first saved, it will automatically be visible to all users. Subsequent page edits will be collected as draft revisions of the page. If a page is edited and saved multiple times while in draft mode, each edit gets logged in the version history:

Draft revisions

The revisions in draft status are highlighted in orange. In addition, they are marked as pending review. These revisions can be compared before the pending changes of the page are accepted. Accepted pages are highlighted in blue.

1.2. Accepting a page

Users can accept a draft page any time they save a page (Accept this unreviewed page):

Accepting pending changes

If the page is not accepted at this point, it can be accepted independently from the editing process from the title section of an article.The draft message will display an arrow which includes the accept function. If a comment is entered, it is shown in the revision history of the page.

Accepting a draft from the title section

The page status now shows the page version as accepted.

Accepted page

1.3. Changes to embedded templates and files

If a page uses templates or contains embedded files and these files have been modified since the page was approved, those changes must also be approved. The wiki can be set up in two different ways to achieve this approval:

1. The embedded resource is located in a namespace without approval feature: If the embedded resource is in a namespace without its own approval function, the resource version at the time of the page approval is displayed. The draft version of the page shows the most recent version of the embedded resource. To approve the resource change, the page istself must be approved again. The approval has to be done on all pages that have this resource embedded.
   
2. The embedded resource is located in a namespace with approval feature: The pages that include the changed resource do not give any indication that the resource has been changed. Which version of the included resource is displayed depends on the configuration of the wiki:

Setting	Description
FR_INCLUDES_STABLE (default)	Always shows the approved (stable) version of a resource, even if it was approved after the page that includes the resource was approved (this works only if the resource is located in a namespace with active approval feature).
FR_INCLUDES_CURRENT	Always shows the latest version of the included resource (this works only if the resource is located in a namespace with active approval feature).

1.4. Quality management overview

The Special page Special:Quality_management_overview allows all users to view and filter a list of wiki pages and their review status. Pages for which a user does not have read permissions are not shown.

Special page Quality management overview

A page can have the following status:

Status	Description
First draft	The page has never been approved. The latest page version is therefore visible to all users (default behaviour) and will be exported in PDFs.
Draft	The latest page revision has not been approved. It will not be exported. Users can switch between the latest draft version and the last approved version of the page.
Approved	The currently valid version of a page.
Not enabled	Pages in namespaces that don't have the Approval feature activated.
Implicit draft	A draft that is the result of an updated resource that is embedded in an approved page.