Useful tips to help you write better knowledge base articles

Title

Keep the title simple and specific to describe the content — but not so technical it cannot be easily understood. Try to be concise.

Abstract

The abstract is short, but remember not to cram as much detail into it as possible. You want to grab the reader’s attention with the first statement.

Introduction

When writing the introduction, pick out the things that are most relevant to your work and explain why, Present the background of your work while focusing on the most important issues.

Timing

• Block out times for writing.
• Consider having regularly scheduled times to write.
• Choose the times according to when you tend to function best.

Writing

• Avoid very long paragraphs and sentences. Nobody likes to read large chunks of text.
• Consider using headings, bullets, italics and boldface (but don’t overuse these).
• Use easy-to-understand graphics especially screenshots wherever required.

Editing

• Before submitting your knowledge base article for approval, read the final version several times.
• Seek feedback from knowledge base users.