Overview
Any IT employee, or individual granted an IT Knowledge role, can create a knowledge article and submit it for review, and approval. Once an article is submitted is reviewed for technical accuracy, format consistency, and other factors before being approved.
Individuals with IT Knowledge Contributor, or IT Knowledge Publisher roles will use the Checklist for Knowledge Approval to evaluate an article.
In this article:
Select Article to Review
- In the Knowledge Base click Articles Pending Review.
- A list of articles pending review will be displayed.
- Click the name of the article to be reviewed. Alternatively, use the search feature to find the desired article.
Review Article
- Read the article and use the Checklist for Knowledge Approval. Paying attention to the following:
- Article formatting:
- Does the layout conform to the published standards (e.g. headers, etc.)?
- Is the text/paragraph formatting being used, and used correctly?
- Article Content:
- Does the article define what its purpose is?
- Does the article actually address its defined purpose?
- Is the article technically accurate?
- Is the article in line with established service offering?
- Article Tags:
- Are tags applied to the article?
- Is it using standardized spelling of existing tags (e.g. Email vs. E-mail)?
- Click Edit Article.
- Click Settings.
- Read the Summary field and ensure that the text is a customer focused descriptive summary of the article.
- Examine the Tags field and ensure that:
- Values are entered
- They are relevant to the article's subject
- Click Permissions.
- Verify permissions are appropriately set for the target audience (i.e. Public vs. Internal).
- At this stage the article is either ready for approval, or rejection.
- If the article is ready to be approved.
- Change the Owner from the original author, to the appropriate Group that represents the service owner.
- Click Save.
- If the article is not ready for to be approved.
- Click Cancel.
Proceed to the Approve or reject new article, or Approve or reject an update to an existing article.
Approve or reject a new article
- Click Approved (or Reject).
- An Approve (or Reject) Article window will open
- Click Notify [Owner] checkbox.
- Enter any appropriate responses in the Comments textbox.
- All articles that are rejected must have the reason(s) for the rejection entered into the comments.
- Click Save.
- If any Shortcuts should be created in other Categories notify the author of the KB article to create the applicable Shortcuts.
Approve or reject an update to an existing article
- Click Pending Review.
- The article will open the draft for review.
- Click Publish This Revision (or Reject This Revision) button.
- If the Publish This Revision is clicked the draft document will be published without any further dialog boxes.
- If the Reject This Revision is clicked, the Reject Article Draft dialog window will appear.
- Click Notify [Owner] check box.
- Enter any appropriate responses in the Comments textbox.
- All articles that are rejected must have the reason(s) for the rejection entered into the comments.
- Click Save.