With Hudu's dual knowledge base libraries, creating and maintaining a vast database of shared knowledge and quick-reference guides, internally and for clients, has never been simpler. Knowledge base articles may be quick-shared with clients, added to client portals, or linked via the related items tab to relevant assets for easy access.
Knowledge base articles can be classified into two primary types:
-
Global articles
- Articles stored within your Global Knowledge Base (KB). These may act as tutorials and how-to guides for internal use or for information that pertains to multiple clients.
-
Client articles
- Articles stored inside of a specific (individual) client/company space, which are useful for storing tutorials and how-to's that pertain ONLY to the space they reside within.
Global KB articles and client KB articles are nearly identical; in abilities, creation, editing, and sharing/relating, the major difference is where they are stored (globally or inside of a client space).
Guides
In this section, we'll cover how to create, edit and manage knowledge base articles.
Creating Articles
KB articles can be created at either the global or client level, and the article will pertain only to the specific KB library it was created within. The steps below apply to both.
- Navigate to either your global knowledge base OR to a client's knowledge base within their client space.
- This first window will show you all of your KB articles in a list format (either all global KB articles or all KB articles pertaining to the client space you're currently within).
- Only articles that you have permission to view will be visible.
- Click the ((+ New)) in the top right-hand corner.
- From this window, you'll need to choose how you'd like to create your new article; your options are:
-
New blank article
- Create a fresh new KB article.
-
New folder
- Create a new KB folder to organize your articles.
-
PDF upload
- Upload a PDF document to create a formatted KB article.
-
New article from template
- Create a new article, starting from an existing article marked as a template.
-
New blank article
- Select the creation option of your choosing, and start writing!!
Editing Articles
Editing existing global KB or client KB articles requires a user role of Author or above; as well as permission to view the article you wish to edit. The steps below pertain to both global and client KBs.
- Navigate to either your global knowledge base OR to a client's knowledge base within a client space.
- Click inside an individual, already-existing article.
- Click the ((Edit)) button in the top right-hand corner of the article page.
- This will open a window containing our WYSIWYG editor; which you can use to write, update and format your KB articles.
In order to publish changes to an article, you must click the ((Publish)) button on the right-hand side before navigating away. Articles do auto-save but auto-save to a draft stage.
Managing Articles
Managing articles requires a user role of Author or above; although only admins and super-admins have access to all management abilities. Articles may be managed individually, or in bulk; we'll explore both options below.
Bulk Manage
The bulk manage option can be utilized when viewing articles in the list; either from the main article page (global or client-specific) or from within a specific folder/sub-folder (when viewing a folder/sub-folder, the bulk manage with pertain only to articles found within that folder).
- Navigate to either your global knowledge base OR to a client's knowledge base within a client space.
- In the top right-hand corner, click the ((bulk manage)) button.
- Alternatively, navigate further inside of a KB folder; you'll have a bulk manage option, specific to the folder you're currently inside.
- From here, select which articles you'd like to manage from the checklist.
- Once articles are selected, you'll have the options to:
-
Move to Global
- Moves the article(s) to your global KB; if the article already exists in the global KB, this option would be moving the article to another folder or to your main KB list (no folder).
-
Move to Client
- Moves the article(s) to another client's KB of your choosing.
-
Archive
- Moves the article(s) to the museum (clients' museum for client articles, or the 'archived' tab for global KB articles).
-
Move to Global
Individually Manage
Within an individual article (global or client KB), clicking ((Manage)) at the top right allows you management of that specific article. These abilities may be limited due to your security user role, but include:
-
Globalize (client KB only)
- Move the article to your global knowledge base.
-
Move
- Move the article to another client space.
-
Mark/Unmark as Template
- Mark this article as a template; allowing duplication of the article for re-use (see Tools - Templates for additional information).
-
Archive
- Move the article to the museum (or your 'archived' tab for global articles).
-
Set Expiration Date (client KB only)
- Choose to designate an expiration for the article; these expirations get placed into the clients' expiration list (and admin global expiration list).
-
Lock
- Mark the article as read-only; dis-allowing further editing of the article.
-
Delete
- Permanently delete the article (admins or super-admins only).
-
Restrict
- Choose to restrict certain security groups from viewing/accessing the article.
Tools
The sections below serve to introduce tools associated with article creation, management, and sharing. Expand each section for an overview of the tool.
KB Folders
Folders act as the primary tool for article organization. Subfolders can be created and nested within folders for further categorization and organization of KB articles; this applies to global and client KBs.
- KB folders can be created at either the global or client level, and the folder will pertain only to the specific KB library it was created within.
KB Templates
Once an article is created (at either the global OR client level), you have the ability to designate the article as a template. Doing so allows you to create articles, starting from an exact copy of an existing article!
Creating Templates
- To mark an article as a template, you'll need to be inside the article itself. From here, click the top right manage button.
- From this window, click Mark as Template. Doing so will allow you to create an exact duplicate of the article, at either the client or global levels.
- Articles created from a template are designated 'child articles' to the original. All child articles created are accessible from the Template section, on the right-hand sidebar of the parent article.
Child articles can be edited/altered to better suit the client/asset they are tied to, this will not change the parent article or any sibling articles.
Quick-Share Links
All of your published KB articles come equipped with the ability to create quick-share links. These are public links to view ONLY the selected KB article, and allow you to easily share useful articles with external users or users who may not have/require portal access.
Once an article has been created; from the right-hand sidebar, users will have the ability to Create Public Share Link. This generates a unique URL, specific to the article you've created it for. The share link may be regenerated or expired at any time; both options disable the previous link created.
The ability to share articles via quick-share links may be removed via security groups/permissions by the admin/super-admin users at your organization.
File Storage
The Files section is a toggle-able module that allows users to add files to an article. Any user can view the files attached to an article that they have permission to view. If a user is at least an "Author" role, they are able to upload their own files.
- Click into the files section on the right-hand sidebar to browse files to upload, OR drag and drop files directly into the section to add. These files will populate into list format.
- To update the name of the file, click the ‘edit’ icon to the right of the file name. Ensure that you click save after updating the name.
There is no limit to the number of files allowed to be uploaded but said uploaded individual files cannot exceed 100 MB per file.
Comments
The comments section allows for simple text-field entries and serves to provide an area for any additional information that may not fit directly into your article or other categories/sections.
Full View
Knowledge base articles need to be scanned and reviewed quickly; what better way than in full view!? Toggle this ability to minimize the sidebars when inside of a specific KB article, while maximizing the article contents; the only way to read an article.
Additional Abilities
The sections below will serve to introduce additional features associated with KB articles. The items below can all be found at the bottom of the right-hand action menu when inside of an article page.
Revision History
Revision histories serve to provide a breadcrumb trail of when edits to the article were performed, as well as by who. Your current version will be notated at the top of the timeline.
To view an older version, navigate down the timeline to the desired previous version.
To revert back to an older version, you’ll need to first select view revision; then revert to this version in the new window.
Activity Logs
Activity logs serve to provide a detailed information page on what actions have been performed to the specific article you currently reside. Any action performed on an article is recorded within the articles' specific activity log; as well as in the Hudu admin Global Activity Logs.
Activity logs can be filtered by:
- Client name.
- The action performed;
- By the user who performed the action;
- or by the IP address from which the action was performed.
View who has Access
This feature will allow admins and super-admins to view who has access to the specific article. Article access can be denied via security groups.
- Users that have access to the article will be designated by a green check mark.
- Users that are restricted from accessing the article will be designated by a red X.
Printable Versions
Physical copies of KB articles may still be required; by clicking Printable Version on the bottom of the right-hand sidebar, you'll open a new tab with a copy of your KB article, in printable format.
FAQ
How do you move articles to folders?
Answer: To move an article to a folder, you can either:
-
- Click on an individual article and select edit in the top right, then select which folder the article belongs from the left-hand side menu.
- Select Bulk Manage from the list view of articles >> select the articles you’d like to move >> move >> select a client (space) >> If folders exist, you’ll be able to choose which folder to move the article to.
Notes: If you’d like to move articles to a folder within the same client, after selecting bulk manage >> move; you’ll need to type in/select the client you currently reside >> choose the folder.
Is markdown editing supported?
Answer: As of version 2.23, some markdown formatting is supported!
Notes: Supported markdown is:
-
- Italicizing (*xxx*)
- Bolding (**xxx**)
- Both italicize and bolding (***xxx***)
- Headings (#, ##, ###, ###)
- Lists (* or -)