UBC Wiki

Wiki Roadtrip: Davis

Davis, California, is home to one of the largest municipal-focused wikis in the world.  As of November 2009, DavisWiki.org had over 14,945 pages, 11,134 registered editors, and averaged 10,000 unique visitors daily.  Not bad for a town with a population of just 65,000 people.   Michael Andersen, writing at the Nieman Journalism Lab, summarizes six lessons that helped them achieve this success:

  • Wikis need content to breed content
  • Business information is the holy grail
  • A wiki’s strengths kick in after one year
  • Start with a subculture, then build out to a general audience
  • Keep your content open source, no matter what
  • Don’t get hung up on mimicking Wikipedia

The entire article is worth reading and most of the lessons learned by the Davis Wiki can and should be applied to the UBC Wiki.  The Davis Wiki started with its founders, Philip Neustrom and friends, creating 500 seed articles – snippets about things that only exist in Davis.  They also hit the streets and did a lot of promotion – such as sticking flyers in the bathrooms at the local university (I particularly like this one).  I think seeding and promotion are two things that the UBC Wiki can be focusing on more.

Ultimately, though, I think a lot of the success with the Davis Wiki is due not just to their ability to just attract users to their site but also to their ability to create a community.  In describing how it wasn’t just the founders who were sticking flyers in bathrooms but also the users, Neustrom explains: People don’t do that for sites they think are neat. They do it for sites they own.

Standard
UBC Wiki

Consolidating the Crops: Revisiting the Main space

The UBC Wiki, as originally described, serves multiple purposes:

  • It is a course repository: The wiki provides a collaborative space for faculty and students to create and share course related content.
  • It is a documentation repository: The wiki provides a collaborative space for the creation, updating, and hosting of documentation, user manuals, and the like.  Using the wiki append plug-in and the wiki book creator, specific documentation could easily be syndicated and republished.
  • It is an open space that anyone can use for any purpose.
  • Finally, it would be a knowledge sharing repository of all things UBC.  For example (again as originally described):

    The genome page [on the UBC Wiki] should inventory UBC resources about Genome – topics like people, groups and departments that research genome; papers, posters and thesis published about genome etc. In the ideal scenario, UBC faculty, students and staff would update topics of their professional (and wider) interests and so make resources more presentable and easier to find.

To accommodate these multiple purposes, the UBC Wiki was divided into four public namespaces: Course, Documentation, Sandbox, and the Main space.  However, as I’ve detailed in my early Course Conundrum post, users tend to not use the namespaces and just create new pages in main space.  To some extent, this problem is getting better.  I’ve created some expanded documentation and created wayfinding aids about the different namespaces. I’m also moving all new pages to their proper space and dropping a note to the page creator explaining what I did and pointing them to the proper help pages.   Finally, I’ve been moving older pages to their proper spaces as well – as you can see I’m close to hitting the 500 page mark.

One thing that would really help users notice the organization of the wiki would be to better define the purpose of the main space:

  • If the main space is intended to be a wikipedia like resource for anything and everything UBC, then this needs to be stated in clearer terms in all descriptions of the main space.
  • “Best practice pages” or better examples of main space articles should be developed so users have a better idea of just what it is we are trying to create.
  • Policies and guidelines should be developed as to what types of content fit into the main space (I’ve started developing some here).
  • The term “main space” should go and it should be renamed with something that better conveys the space’s intended purpose, such as UBCpedia, UBC Dictionary, UBCompendium, or (my favourite) the UBCnomicon

Of course, these suggestions apply to all namespaces.  However, since the main space is the most prominent part of the wiki, clarifying its purpose would help clarify the the purpose of the other areas as well.

Standard
MediaWiki

Learning by Doing, Training by Tinkering

I installed a local version of MediaWiki on my laptop today. MediaWiki is the software platform on which the UBC Wiki runs and I wanted to go through this process for a couple of different reasons: First, I hope to be able to do some experimentation with the UBC Wiki without having to bother the development guys who keep it running and healthy. Second, I really want to get a better grasp of how MediaWiki works behind the scenes. Afterall, while knowing how to drive a car is often all the knowledge you need, having a basic understanding of how the engine works can be the difference between a good day and a really expensive one.

At any rate, installing MediaWiki was much easier than expected. MediaWiki is a web application and to get it to run on a laptop, you need to have a program that can act as a localized web server, such as MAMP. After installing MAMP, I downloaded the latest version of MediaWiki (the 1.16 beta that has the new and sleek vector skin). I saved the MediaWiki files in the MAMP htdocs folders and then I just followed the basic steps outlined here.

It was quick and painless process and already I’ve begun to get a better idea of how the UBC Wiki is configured and what sort of effort it would take to add additional extensions. As I gain a further understanding of how the engine behind the UBC Wiki works, I hope to gain a clearer picture of it’s potential and how to keep it better organized. And, just as my folks never wanted me to tinker under the hood of their car, its good to have my own copy on which I can learn.

Standard
MediaWiki

Converting Documents into Wiki Pages

In addition to an overall organizational structure, a wiki also should have some organization within its individual pages. The use of headings, subheadings, bold, bullet points, and the like make an individual article or page easier to scan, navigate, and read. Most of the internal page organization can be easily accomplished through the use of formatting and Wiki Markup. However, a problem that I’ve noticed is that a lot of users do not write their content directly in the UBC Wiki; instead they most likely use a word processor to draft and format their text and then copy and paste that text into the wiki. Unfortunately, word processor formatting does not often transfer well into MediaWiki. Thus, the user has to take additional time to reformat their content on the wiki. Often, though, they just leave their content as is, which can look pretty bad and be hard to parse.

I wanted to quickly point out a couple of tools make getting content from a document into wiki page a bit smoother. The first is an extension for Open Office, the free, open-source word processor program which is a pretty great alternative to MS Word. The Sun Wiki Publisher extension allows a person to type up a document in Open Office just as they would normally, and then save it in a MediaWiki format. All formatting, such as links, bullet points, and headers, is automatically converted to Wiki Markup. In my basic testing, this extension works really well and can handle even moderately complex tables.

I have yet to find anything that works as well for Microsoft Word. The easiest strategy seems to be to save the document as an HTML file and then to copy and past the HTML into an online Wiki Syntax converter and then copy and paste that output into the wiki. Novak recently recommended this HTML to Wiki converter and it works well, especially if you are using HTML directly from a website (which is how this UBC Wiki page was created). Unfortunately, when converting from Word to HTML to Wiki Mark-Up, the process is not quite as smooth and some reformatting or tweaking of the Wiki Markup seems to be necessary. Still, its better than having to create a table from scratch or insert a ton of links into a list.

I’ve created a couple of Help pages on these topics: Converting Documents to Wiki Syntax and Converting HTML to Wiki Syntax.

Update:: Brian points out in the comments saving a Word document into HTML and then converting it doesn’t work all that well. I agree and I’ll keep looking for better solution.

Standard