Home > KCS v6 Practices Guide > Section 2 The KCS Practices > The Solve Loop > Practice 4: Improve

Practice 4: Improve

Table of contents

Overview

In the process of finishing a KCS article (once the resolution is known), we apply our best judgment about what information to include in the article. We will often capture information that has no relevance to the issue based on understanding the resolution, and we should be sure to remove information (particularly in the environment statements) that ends up being irrelevant, misleading, inaccurate, or inappropriate to the audience.  We want to capture relevant, accurate statements using our preferred vocabulary in the environment field. We want as much consistency in how we describe the environment as possible. And, we want as much diversity in the issue statements as requestors use to describe the issue. 

 

Once again: the issue or symptom statements in the article need to reflect the requestor's experience; technical accuracy is not required.  When we improve existing articles, we want to add to the issue statements - not rewrite, edit or delete the ones that are already part of the article. We have to assume that, no matter how incorrect or ridiculous they may appear to us, the statements represent the requestor's part of the article and reflect how they perceived the issue.  This is what makes the articles findable by others who are likely to have a similar perception of the issue.  

Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.