Confirmed users
3,193
edits
Support/Q2HelpfulnessTests: Difference between revisions
→Changing KB Article language
Michaelverdi (talk | contribs) |
|||
| Line 13: | Line 13: | ||
== Article tests== | == Article tests== | ||
=== Changing KB Article language === | === Changing KB Article language === | ||
The current KB articles do a good job of speaking directly to the user and answering their questions. We'd like to test what impact changes to the language of the article have. For this test we'll work on rewriting each article, making these changes: | |||
*Remove unnecessary information - There are almost always lots of tangential pieces of information related to a topic that could be presented. We should look to remove or not include anything that isn't necessary to solve the problem and get the user on their way. | |||
*Use non-technical terms where possible - As SUMO contributors we're familiar with many technical terms and abbreviations. We shouldn't assume that people using the KB are familiar with any of these terms. We should explain things in as plain and simple language as possible. | |||
*Use a conversational or friendly style - The articles should read more like your friend is explaining something to you and less like you are sitting in a lecture. | |||
Here's the opening paragraph of the Profiles article: | |||
*Firefox saves your personal information such as bookmarks, passwords, and user preferences in a set of files called your profile, which is stored in a separate location from the Firefox program files. | |||
Here's an example of the kind of rewrite we propose to do: | |||
*Did you know that all of the settings you make in Firefox, like your home page, what toolbars you use, saved passwords and bookmarks are all stored in a special profile folder? It's true. This article will tell you why this is a good thing, where you can find your profile folder, and give you links to related articles. | |||
=== Embeding screencasts inline === | === Embeding screencasts inline === | ||