The Now Platform® Washington DC release is live. Watch now!
This blogpost describes the templates we have found useful for our internal Support teams to create KB articles, normally created from the cases they are working. This is an internal KB article, but we wanted to provide an example of the types of content we make available to the people creating our content.
Issue: List all of the symptoms that the customer is experiencing. Use the language the customer used when filing the incident.
Cause: Explain the origin of the issue in customer-friendly language. Provide technical details if they are useful, but ensure that technical information is appropriate and useful to share with customers.
Resolution: Provide numbered steps that the customer can use on their instance to resolve the issue or provide relief.
Additional Information: Add links to more resources such as a page in the product documentation, a blog post on the ServiceNow Community, or a video on the ServiceNow YouTube channel.
Note: If you are authoring an article describing how to use an aspect of the product, first make sure that the product documentation does not already cover that topic. If you feel the information is too urgent for customers to have to wait for a documentation update and you need to create an interim article, note the article number in your documentation feedback so when the change is incorporated, you can easily find and delete the placeholder article.
Description: Describe the task covered in the article.
Instructions: Provide numbered steps for how to accomplish the task.
Additional Information (optional): Provide any helpful additional information.
Note: If you are authoring an article describing a feature or functionality, first make sure that the product documentation does not already cover that topic. If you feel the information is too urgent for customers to have to wait for a documentation update and you need to create an interim article, note the article number in your documentation feedback so when the change is incorporated, you can easily find and delete the placeholder article.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.