Create a new article

Last Modified on 10/27/2022 10:07 am EDT

This article is for Ask Athena Content Creators and describes the steps for creating an article in KnowledgeOwl.

Before you start, you will need access to the following:

Step 1: create an article

  1. Navigate to https://app.knowledgeowl.com/login
  2. Login using your KnowledgeOwl credentials
  3. In the top-left, click Knowledge Base and select Articles
  4. Select a category and any relevant subcategories
  5. Within the category/subcategory menu, click + Add Article
  6. Enter an Article Title
  7. Select Create from template (Do not create a new article from scratch)
  8. Choose a Template Article
  9. Click Add and Edit

Choosing a template

  • How-to: Best for step-by-step instructions on how to perform a task or closely related set of tasks.
  • Informational: Best for describing how a service or set of tools works at Bryn Mawr.
  • Service Catalog: Best for advertising various services and/or comparing them.

Step 2: configure title and tags

  1. Follow the instructions within the template to enter and format content
    • Delete style notes and unnecessary snippets and sections
  2. Add an Internal Note if the document is a work-in-progress
  3. Type in the title for desired Tag(s) and select an option that autofills
    • If a Tag does not autofill, try different phrasing or capitalization
    • If a Tag does not exist, submit a change request for it to be created
  4. Type in a Search Phrase if the contents of the article are not summarized by the title
    • Search Phrases should be 1-3 words
    • Do not add more than 10 search phrases
  5. The following settings should be ignored:
    • Short Title
    • Internal Title
    • Title Tag
    • Meta Description
    • Thumbnail
    • Banner

Step 3: configure article settings

  1. Select the appropriate Publishing Status
    • Draft: for all new articles before they are Published
    • Ready to Publish: for articles made by Content Creators, but are ready to be published
    • Published: completed article, ready to go live
    • Needs Review: completed article, ready to go live, but requires follow-up
  2. Leave Author as-is
  3. Change Category, if necessary
  4. Select an Article Call Out
    • New: recently published
    • Updated: new major version
    • Leave Status Expiration as-is
  5. Regarding Versions
    • All new articles are created as version 1.00
    • Minor changes (e.g., corrections, small additions to content) or major changes (e.g., reformats, rewrites, add/delete section) should be completed in a new minor or major version, respectively.
    • Once created, click the hyperlink to change which version you are viewing/editing.
      screenshot displaying the hyperlinked versions section of an ask athena article
    • When ready to publish, scroll up, check the box for Activate this version and click Save.
      screenshot displaying the version status section of an ask athena article
  6. Regarding Related Articles
    • By default, KnowledgeOwl automatically populates related articles. However, if there are specific articles that are explicitly related to the current document, they can be linked by clicking Add Related Article.
  7. The following settings should be ignored:
    • Internal Flags
    • URL Redirect
    • Inherited Restrictions
    • Restrict to Groups
    • Restrict Editing to Teams
    • Restrictions
    • Recommended On Pages
  8. Click Save
  9. Click Preview or View Article

Related Articles