How does one make wikis work? - Trumpi's blog

How does one make wikis work?

We've recently installed a wiki for the project that we are working on. A wiki is a great collaboration tool and it has proven itself in the past, replacing Excel spreadsheets in several collaboration scenarios.

My question is: How does one prevent the wiki from becoming a dead artefact in the project? Putting it more specifically, How can one ensure that every team member contributes what she should to the wiki?

I don't have a definitive answer to this question. What I am after is that the community here shares links, tips and guidelines that have really worked in making a project wiki a success. So please blog (and trackback) and comment!

Some more questions that I have:

  • What wiki solution do you use in your organisation? What motivated that decision?
  • Would you consider paying money for a wiki solution?
  • What do you put on your wiki? What do you not put on your wiki?
  • Is there be elements of your wiki that should be versioned alongside the source code?

My initial thoughts:

  • Don't put source code on your wiki - this belongs in version control.
  • Do put the project milestones on the wiki, or at least link to the system that publishes your project milestones.
  • Do put the location of your source code on the wiki. Be careful if the wiki is visible from the internet -- you do not expose information that you do not want to expose.
  • If an email is sent to the team regarding the source code, a change in the process, a how to, etc. then take the contents of that email and put it onto the wiki.

Your thoughts?

Published Sunday, November 05, 2006 12:32 PM by trumpi

Comments

# re: How does one make wikis work?

We're using a wiki on our project and I must say, not having used one before, I do not know how you can survive without them. Like you said, they're _way_ better than excel / word docs, mostly I think because they're so easy to edit. The _viewer_ and the _editor_ are both little more than a url away. The project has so far been going for about 4 months and though the wiki worked very well in the initial stages, it's value has tapered off because for one, the information is ageing and for another, the structure is not optimal. i.e, the wiki layout that you put up at the start, is probably not going to give you enough space to grow. Interesting, I think I'll post on my blog about my experiences with wiki's.

Friday, December 01, 2006 10:27 AM by Michael Wiles

# re: How does one make wikis work?

If you are looking for using a .NET wiki engine, have a look at ScrewTurn Wiki (http://www.screwturn.eu/MainPage.ashx).  Version 2 is currently in beta and the engine has some really cool features.  The installation is also a snap using the installer and you don't need to use have IIS installed on the box either.

Sunday, December 03, 2006 9:29 PM by cjlotz

# Wiki patterns

How does one make wikis work? I posed this question in a previous post on this blog. It seems as though

Saturday, February 17, 2007 10:43 PM by Trumpi's Blog