DoIT Internal Operations - KB Documentation Upkeep

This document outlines the steps taken by an Internal Operations Student Assistant to review and update Departmental Support service documentation.

Background

In January 2025, DoIT Departmental Support service documentation was moved from Confluence/Wiki to the UW-Madison Knowledgebase (KB).

In the past a student assistant was assigned to oversee the general upkeep of these documents, which includes monitoring expired documents, receiving comments related to the documents, and making the necessary updates.

As of October 2025, a student assistant or staff member will need to be identified for this work to continue.

Expired Documents

All documents have a set expiration date; once expired, the documents are no longer active and will need to be reactivated by extending the expiration date.

  • To view expiring documents, click on the "expiring" tab on the left panel of the KB. This tab will show documents with expiration days within a week.

expiring tab location

  • Before updating the expiration date, check that the document follows the KB organizational guidelines.

  • If not, update the document to match the guidelines unless it is a document that is personally maintained and used by the creator. It's often hard to judge, but the goal is to not mess with a document that is not widely used as it may upset the creator.

  • After reviewing the document, select the small box on the far right row of all documents you wish to update and then set the new expiration date and time to a year from today. 

updating expiration date

Comments

Occasionally, employees will leave comments on documents. Review the comments and update the pages accordingly

  • Navigate to the "feedback" tab on the left panel. This tab shows all comments left on documents.

  • Sort them in order of most recent to least recent by selecting "ID Descending" in the search/display filter section at the top of the page.

updating expiration date

  • View new comments and decide whether to change the document or not. If the feedback is content related, you can reach out to the owner of the document to get verification that the feedback is correct and should be adopted.

  • Mark the feedback as resolved and use best judgment regarding alerting the commenter. It's often encouraging to leave them a message thanking them for their feedback so they continue to leave feedback in the future. We want the KB to be as accurate as possible and comments help achieve that goal.

Feedback Page

  • Make sure the document is active, and then continue to the next article of feedback.


Keywords:
Documentation Student Internal Operations KB Knowledge Base Assistant Departmental Support Expired Expiring Comments Edits 
Doc ID:
147628
Owned by:
Christine C. in DoIT Internal Ops
Created:
2025-01-21
Updated:
2025-10-17
Sites:
DoIT Internal Operations Team