Rice Knowledgebase: Guidelines

This document provides the guidelines for the migrating current how-to documents and quick reference documents from the Do-IT Yourself section of the wiki known as Docs (docs.rice.edu) to the KnowledgeBase (kb.rice.edu).

Terminology Usage

When using KnowledgeBase [KB] terminology, always use capital letters “K” and “B”. Additionally, use KB abbreviation with capital letters “K” and “B” for short.

Create Document

Authors and Admins of documents for the Rice University OIT KB should adhere to the following guidelines. This includes new service documents; reviewing a current document; and/or migrating a document from docs, website, and other resources. Check KB for any duplicate documents/information.

Title of Document

The title of document should be consistent throughout the KB. For example: Office 365: FAQs and Office 365: How to Install Add an audience specific statement for clarification purposes. Currently Office 365 has limited support for Rice faculty, staff, and students.

Add keywords

Identify the intended audience: All, Faculty, Staff, Student Use “All” if this document applies to everyone. Use the specific audience if the document is for a specific targeted audience. For example, Google Mail, the audience would be “student”.


The current topics used in the Do It Yourself (DIY) section will be used for the KB. Additional topics can be added as needed. Submit request to KB Admin. Check KB for duplicate information.


In the initial phase of this project, all documents will be subject to a review by KB Admin, service owner, and/or peer reviewer.


Review document for technical accuracy. Use a non-technical person to test the usability as necessary. Add “comments” when sending draft to author for changes. Be sure the “periodic review date” is set for the author/owner to be notified. Note: May 31, xxxx / end of the semester. Use summer months for new, review, modifications, or archiving documents.

Keywords:KB, KnowledgeBase, Rice, training, author, admin, workflow   Doc ID:63990
Owner:Diane Y.Group:Rice University
Created:2016-06-09 18:14 CDTUpdated:2020-06-08 10:29 CDT
Sites:Rice Sandbox, Rice University
Feedback:  0   0