Using a wiki to document Isaak, Brock University’s Sakai-Based LMS

Mon Nov 23 12:02:21 2009 EDT (-0400 GMT)

Main Page - Information about Isaak, Brock University's Sakai-Based LMS (20091123)Brock University’s documentation for Isaak, Brock University’s Sakai-Based Learning Management System (LMS), is maintained within a wiki at kumu.brocku.ca/sakai. This wiki is intended to be a practical, readable, guide that is aware of the context that instructors use Sakai/Isaak for teaching at Brock University.

What follows I had actually hoped to present on this at the last Sakai Conference. Brock University is not a member of the Sakai Foundation, but had intended to become one, as such the ambiguity made it hard to register.

Brock University offers only a few on-line or distance courses and as such Brock’s LMS functions primarily as an additional channel of communication; content distribution; and community for otherwise face-to-face courses based at one of the two physical campuses. This amounts to slightly more than a thousand courses with faculty responsible for their own course spaces with complete control over it. The responsibility for assisting instructors in their development of on-line course content falls upon myself and the other important members of the Centre for Teaching, Learning and Educational Technologies (CTLET) at Brock University.

The CTLET strives to offer a high level of support through: one-on-one consultations, workshops, E-Mail dialogues and phone-based support, but one thing is certain; every instructor cannot expect that when they need help with Sakai/Isaak that they can pickup the phone and get someone immediately. If the answer to every question about Sakai/Isaak could only be found at the other end of a telephone the ability to distribute critical information would be severely limited and it would represent a considerable bottleneck.

Personal one-on-one help is important and very effective, but it is also resource intensive to deliver. University technical and pedagogical support staff work conventional business hours, however, instructors need not work from their office nor work conventional business hours. These are schedules and locations that do not always compliment each other.

Main Page - iTunes U at Brock University (20091123)The web is the best tool for infinite access to the same resource and to that end the CTLET look to Wikis to document things like WebCT, Sakai/Isaak, Brock University on iTunes U, etc. This decision to use a wiki was because of the constantly evolving nature of these teaching tools and the scarce resources of the Centre: It was just more timely to write-up articles that explain things or to write a how-tos that were sufficient and then post them. We could then come back latter and improve the articles. It also ensured that everyone could contribute to the documentation; including users, other support professionals on campus and occasionally students.

The software selected to power the wiki was MediaWiki, as it is a well known software that powers Wikipedia. The slightly cryptic syntax for creating articles is hopefully more accessible because of its use in Wikipedia.

The CTLET’s staff are by far the most frequent contributors, and my understanding is that wikis have a motivated core that maintain the site and contribute the most while the vast majority of readers do not turn into contributors. When it does occur the help of others is appreciated. As the original author of an article being able to edit the article quickly in someone else’s office with the edge case of Windows 2000 and Office 2002…. etc, is very helpful.

With Sakai/Isaak we also have the added bonus of being able to build on the Sakai Educational Community License which is deemed to be compatible with the wiki’s Creative Commons 2.5 Licence. Wherever we based one of our wiki articles directly on the Sakai help file we place a template at the bottom of the article to indicating that, ie. kumu.brocku.ca/sakai/Add_or_delete_calendar_fields

help_scrape.phpsWith these open-source licenses in mind I wrote a script scrape the basic Sakai help information and format it into a MediaWiki export file which was imported into the Wiki and formed the basis of a number of articles. The source of that script is presently located at mattclare.ca/wordpress/wp-content/uploads/2009/11/help_scrape.phps_.html .

How You Can Use A Wiki

If you are interested in starting your own MediaWiki based Sakai documentation this script will generate a version of the 2.6.1 help information in a format that can be imported into any MediaWiki wiki. All are welcome to make use of it, but please be warned that I have never been taught anything about writing a parser and this script was to be a one-off.

Another option would be to export certain categories from our current Sakai/Isaak wiki, which could possibly give you too much information, especially too much Brock University information. But if you’re interested you can export whole categories by name at kumu.brocku.ca/sakai/Special:Export.

In both cases the user who is going to import the file into MediaWiki needs to be a MediaWiki SysOp.

Anyone is welcome to copy and paste Brock University Sakai/Isaak documentation into their own, provided that they respect the original licence under which it was published.

I asked the same of Rutgers and the University of Indiana and both responded that it’s posted under a creative commons licence for that purpose.

If you use any of our wiki articles for your wiki a small mention, like how we reference Indiana University’s Oncourse Help, would be nice. Here’s an example: kumu.brocku.ca/sakai/Podcasts

Something like this would be appreciated:

Brock University Sakai/Isaak Help

This article is based on the equivalent Isaak, Brock University’s
Sakai-Based LMS, help article found at: kumu.brocku.ca/sakai.

All respective sources used are under a free-for-reuse license and
additional permission has been obtained.

If you would like to replace Sakai’s own help files with your institution’s MediaWiki articled here are the two additions that
are required to the respective configuration files to make the Sakai help buttons point towards the wiki:

sakai.properties (Sakai’s settings file)

#Redirect Help to Wiki site
help.redirect.external.webapp=https://kumu.brocku.ca/sakai/Help

“httpd.conf” (Apache web server’s settings file)

RewriteRule ^/sakai/helpsakai.(.*) kumu.brocku.ca/sakai/$1 [NC,L]
RewriteRule ^/sakai/(.*).tool$ kumu.brocku.ca/sakai/$1 [L]

Our Success With Wikis

The experience of the Sakai/Isaak Wiki and the WebCT Wiki before that has been very positive. The CTLET’s staff added most of the content, but some has been amended and revised by other staff members and stakeholders at Brock. Most importantly, those who are trying to make use of the documentation have also contributed. Some edits have been substantive, while others have been made to correct errors or typos such as “hte” in the place of “the”. The most viewed article in the wiki is the FAQ which has been viewed over 27 thousand times. The FAQ, or Frequently Asked Questions, article has gone through a number of revisions to refine answers and add or remove questions to ensure it is always current.

I have actually presented on the WebCT Wiki and podcasting at Brock University in my presentation “Teaching Support 2.0”, given at OUCC/CANHEIT 2006, May 28 – 30, 2006 at Guelph University and Canadian WebCT E-Learning Conference, June 19 – 27, 2006 at the University of Alberta. I apologized then for the title then and I’ll apologize for it again here.
Popular pages - Information about Isaak, Brock University's Sakai-Based LMS (20091123)
A measure of the wiki’s success might be its most popular pages or the most linked-to categories or most linked-to pages.

I hope you will consider a wiki for documentation projects and tool as we have at the CTLET at Brock University. Wiki articles benefit from constant revision and the experience of users making articles very timely. Anyone who is motivated can update the resource and everyone benefits from the small contributions of users in the larger repository. This is in contrast to previous methods of offering text-based support: rapidly ageing and easy to lose manuals, flyers and guides. Though most of the content of the Sakai/Isaak wiki is still created by the CTLET the ability for each article to be edited by anyone from anywhere provides considerable. Using the Wiki medium information can be added and re-shaped and added to again to create an organic, living document that involves the learner in their learning.


Sakai Conference 2010 presentations

Subject to change without practice ;)

  • Mathieu Plourde

    Thanks for sharing Matt, I think I’ll pass this post around to get some feedback. I’ve been messing around with Drupal for a while with mitigated results, but we don’t have an institutional wiki at Delaware.

  • Pingback: Denver Sakai Conf 2010 | iMatt :: The Blog of Matt Clare()