Knowledge Base Article(s) Guidelines

These articles will serve as a structure for creating KB/Troubleshooting articles in Confluence

As a basis for ALL articles, be sure to use proper grammar and DO NOT include the word "you" (in reference to who articles are directed at) in anyway. Please proofread articles to verify accuracy of content.

DO NOT include personally identifiable information. Replace any names, emails, phone numbers that could be linked to yourself, staff, or students with generic information.

How-to articles

Describe how this guide is most effective for what the article is being wrote for

Begin with the most relevant step to start the process
Continue the written walk-though processes for each step
1. Based on the article, organize it's layout by using Sections, Columns, Expand and/or Panel macros
  1. Use sublists for keeping troubleshooting steps organized and most relevant

Informative info.

Use the "Info" macro for highlighting information that is helpful to the article but may not apply to the issue itself

Noteworthy info.

Use the "Note" macro for highlighting info that is important, but doesn't necessarily NEED to be portrayed

Must-have info.

Use the "Warning" macro for highlighting critical info that NEEDS to be portrayed

FOOTER Tip Box

Include the following in a Tip macro:

If there are any questions or issues please contact IT Services

Troubleshooting articles

Problem

Give an overview of the issue the article is being wrote for and describe how the process will be applied to amend the issue

Begin with the most relevant troubleshooting step(s) to help eliminate easy fixes
Continue on with a list, or add other elements such as Sections, Columns, Expand and/or Panel macros to help maintain an organized layout
1. Use sublists for keeping info. together, and insert more detail
  1. Use images/links, bold, italicize and underline to highlight important info.