How to Create a KB Article

TeamDynamix → S&T Client Portal → Knowledge Base

1. Select the Category that you would like to create the article within. 

Uploaded Image (Thumbnail)

2. Once inside the correct “Category” or folder, click + New Article on the right-hand side of the screen.

3. Double check that the Category section matches your intended folder. You can change to a different folder or a more specific sub-folder by typing the name of the folder or clicking the “magnifying glass” search icon on the right.

Uploaded Image (Thumbnail)

4. The Order section refers to the listed ordering of the articles within the folder. By default this will be set to “1.0” and all articles will be sorted in alphabetical order.

If you would like a specific alternative ordering for the articles, you can alter the numbering (1 refers to the first article listed, 2 for the second, and so on).

Or if you would just like this specific article to be “Pinned” to the top of the folder regardless of the existing order, check the Pin Article option:

Uploaded Image (Thumbnail)

5. Fill in the title of the article in the Subject section.

6. The Body section contains the actual bulk of the text in the article.

You can manually type or copy/paste your text directly into this section.

 If you would like to paste/upload an HTML file of the article, you can paste directly into the main body section. Or you can click Source in the upper-left corner to view and edit the source code. To exit this mode and return to the normal Text view, click Source again.

Uploaded Image (Thumbnail)

7. The Article Summary section is for a brief (one to two sentence) meta-description of the article and the information contained within. This summary will appear underneath the article title when the article is displayed within a Category or pops up on a Search.  See the example below:

Uploaded Image (Thumbnail)

8. The Tags section is effective with SEO (Search Engine Optimization) keywords — essentially, if someone were trying to look up an article in the search bar, but couldn’t remember the exact title, typing any of the keywords in your Tags list would cause the article to show up in the search results. You can always create your own tags (simply by typing them in), but most of the common phrases and terms specific to S&T TDX already exist. Once you start typing, terms will show up in the dropdown bar and you can click to add.

Uploaded Image (Thumbnail)

9. The Status section pertains to the publishing status of the article. On a first draft, it is suggest using the Submitted status (in which case the draft is available for you to edit as need be, but is not publicly viewable yet). The Approved status is used to officially “publish” the article in its final state and make it viewable to all users with permission.

Uploaded Image (Thumbnail)

► Alert: If the article is in any state other than Approved, it is not publicly viewable.

10. Setting the Review Date is optional, but a good practice for teams to decide on how often information should be reviewed and updated (every few months, once a year, etc). At the given Review Date, the owner of the article will receive a reminder to review it (at which point it may be appropriate to make edits to outdated information, or to “archive” the article).

Uploaded Image (Thumbnail)

11. By default, the Owner of the article will be set to the user that is currently logged-in and creating the article. In most cases, it is a good idea to change this user to a team email. To do so:

      a. Click the "magnifying glass" search icon on the right-hand side.

Uploaded Image (Thumbnail)

     b. Select the Groups option, and type the name of your team into the search bar.

Uploaded Image (Thumbnail)

     c. Click on the corresponding team name.

Uploaded Image (Thumbnail)

► Tip: If you check the Notify Owner on Feedback box, the owner email will receive direct notifications when someone leaves commented feedback on an article.

Uploaded Image (Thumbnail)

 

12. Perhaps the most important step: Don’t forget to click Save!