Introduction

The Knowledge Base tool  (KB tool) is a complete knowledge base application that replaces the help-function of Sakai. It is context sensitive to sites, tools, permissions, level of experience, and it features a Lucene/Solr search engine. It was initially developed for the University of Amsterdam by Edia.

Key features

Use case

As organizations implement Sakai, many choices are made concerning the tools, user types and permissions that are used. Many instances are also customized to specific local needs, audiences or application areas. This makes most instances unique. The usecase for the development of the KB tool is to enable multi-level and context aware end-user support.

Finding & viewing

Articles inside the KB consist of text, media (video) and relations to other articles. Additional information on articles includes rating, comments, difficulty and required permissions. In order to search and find information, the knowledge base allows users to browse categories (tools, user types, permissions, difficulty) or search (full-text & lemmatised query). Results are shown in a sortable table as shown in in the screenshots below.

Authoring

The KB tool has an interface for both end-users and authors of support documentation. The latter requires the knowledgebase.edit permission to be activated in the site or !user realm. Having the knowledgebase.edit/delete permission, authors can add, edit and delete articles in the KB.

Context

Similar to the standard Sakai help system, the KB can be used to replace the context-aware support information on the level of a single tool. By clicking the help icon in a tool, the KB will select all articles related to a tool that correspond with the user's current site permissions.
 Activated as a tool on a site level, the KB tool will only display support articles about the tools that are active on the pages of a site.

Tool status

Date

Description

14-07-2009

The KB tool will be taken in production in the summer of 2009 at the University of Amsterdam. The tool will be available under an open source license (ECL) in the next month. The next updates of this page will include a link to the source code and installation guidelines.

01-01-2010

Th KB tool has been in production for some time now.

22-03-2010

The KB tool is available for download at the Edia contrib svn repository

04-05-2011

The KB tool is migrated to 2.7,

https://source.sakaiproject.org/contrib/edia/knowledgebase/branches/sakai-2.7.x/

 

Installation and setup

The installation and setup guide can be found here:

Installation and Setup Guide

Future directions

We are looking for partners/institutions to create articles in multiple languages. If you are interested in contributing, please contact us.