Skip to main content
This tuesday I'm going to do a workshop on wiki for some people in management/business development department. We've been smart enough to choose Confluence for our internal wiki, and its use has been growing steadily ever since last summer, bout the same time as I joined the company.

Over this time I've managed to earn the rep of a wiki-evangelist within the company. This is probably I've taken the time to learn the in's and out's of Confluence content formatting, making pretty layouts with columns and tables, galleries, RSS-feeds, and intranet blogging. Some people think I spend too much time fiddling around with it (see for instance the screenshot of my personal space page), but I think it's fun and interesting to try out. I'm not doing it to evangelize the whole company into going crazy on wiki-usage, I just use the wiki to cover my own butt mostly.



If I didn't write things down in the wiki, I'd very quickly fall into the state of corporate goldfish memory, where the only accessible knowledge would be the one found in my brain, and most of that would be about the projects I'm working on right now. Not half-a-year ago or several years ago.

Instead of trying to remember old projects, I write down stuff every day. It could be anything from 5 to 50 lines, and mostly they're about what I have done, and what I'm going to do. These are for my own reference, not for project documentation. The archive is searchable, and I find my own (and others') notes being more and more useful.

But enough personal motivation. The thing I wanted to write about today is how I'm going to present the use of our beloved wiki for the management.

So, let's start with the cons we've got. These are reasons why management would not like to use the wiki:

  • They've already got an existing intranet. Adding another adds to the complexity of the infrastructure.
  • There is no special interconnection with MS Office/Exchange software.
  • It's another tool to learn (and wiki markup ~> programming language)
  • Suspicion towards wiki access control.
So, to sum up, the Wiki is hard to use, hard to control and does not work well with the existing infrastructure.

So let's start off with these points and break down the wiki-hostility :)

Complexity
The wiki is designed to be a simple tool. It builds on the very basic standards that define the success of the Web today. A wiki does not add much complexity because it is not complicated. It's just a simple web-application that can use your existing user directory service (LDAP), and beyond that it doesn't affect your existing systems (except the competition it adds to your DMS-systems/intranets).

No MS Office collaboration
We'll admit to the fact that there is no special compatibility between the content of your wiki and the content of your Word documents. We (as in us developers) would argue that this is a problem of MS Office not following industry standards, but management hears "bla bla bla our stuff does not work with MS Office", a very bad thing indeed since MS Office is the platform on which they rely to do most of their job.

Now you can upload Office documents as attachments to the wiki, but that's about it. Other than that we can't do much except recommend that management puts their document in explicit, transparent wiki content so they can enjoy the functionality of search, versioning and XML-export.

The learning curve
Once you get into it, wiki-markup is really easy. And if it's still too hard, you can still use the WYSIWYG editor. The issue is also countered by Confluence's excellent documentation.

Access control uncertainties
This is perhaps the most prominent show-stopper for wiki embrace in an organization. It is not only about security and confidentiality. Members of management have a certain.. sovereignity they must perform onto the content they create.

One manager's content is an important artifact. Often it should only be viewed by a select few, and naturally not edited by anyone else than the manager.

The wiki brings with it a message of free access to all content. Everyone can edit everything. This sounds risky to management.

Luckily, Confluence comes with great possibilities for administering access control. Will have to make a point of it on the presentation.



Now I better get started on the presentation. Will include these points, as well as some short history of wiki, the role of wiki (as a Knowledge Management tool?), and finally assignments! (wee, I get to boss management around)

Comments

  1. This is kind of of topic, but is there any particular reason you would recommend confluence over, say, mediawiki, instiki og moinmoin? Most confluence sites I have seen have been hard to understand and navigate, but that might be just me (it often is). What's so special about Confluence? (Maybe a subject for another post?)

    ReplyDelete
  2. I wouldn't want to push any particular wiki brand too hard, but mainly I think Confluence has earned its "enterprise wiki" label over the way it enforces structure.

    In any conventional wiki you will have to forge your own structure on conventions throughout the wiki pages, while in Confluence all content is divided into Spaces under which all pages are connected as hierarchies, rather than one big flat collection of pages.

    There are other reasons as well, but to me this is the biggest one. I realize you have the opposite experience, but that may be because of badly implemented navigation, or maybe I've worked with Confluence so much that I've grown used to it :)

    I've done alot of work in Trac and MediaWiki as well, and they were good. But being in a larger organization I'm worried ordinary wiki's would quickly fall into chaos.

    ReplyDelete
  3. This is an interesting post Thomas! I just want to add some points to you when you say:

    "Now you can upload Office documents as attachments to the wiki, but that's about it. Other than that we can't do much except recommend that management puts their document in explicit, transparent wiki content so they can enjoy the functionality of search, versioning and XML-export."

    The search also covers Excel, Word and PDF -files which is uploaded as attachments.. So the search abilities is actually great!

    On another note: Confluence is fast gaining momentum in many organisations these days. Where I work (Computas) we have bought Confluence for use in projects and to be used as a collaborative tool within the rest of the organisation. This being said it does not replace the intranet, but it can help the intranet not being cludded with all kind of information that you actually want to be edited and maintained by the users themselves. One example could be our Knowledge Management (KM) "group" which meet once a month to discuss different topics within KM. By using a wiki we are all able to edit the content and share our ideas both before and after the meeting. We even upload presentations, articles etc.. to share with the others. In an intranet this is typically administrated by an editor or one person.. This being without any way of giving feedback directly on the page.

    ReplyDelete
  4. Thanks for your comment, Thommy, and thanks for clearing up the Office-document search issue. I'm sure we'll be discussing the subject (of Confluence and wiki's in general) over a beer in the near future ;)

    ReplyDelete

Post a Comment

Popular posts from this blog

Open source CMS evaluations

I have now seen three more or less serious open source CMS reviews. First guy to hit the field was Matt Raible ( 1 2 3 4 ), ending up with Drupal , Joomla , Magnolia , OpenCms and MeshCMS being runner-ups. Then there is OpenAdvantage that tries out a handful ( Drupal , Exponent CMS , Lenya , Mambo , and Silva ), including Plone which they use for their own site (funny/annoying that the entire site has no RSS-feeds, nor is it possible to comment on the articles), following Matt's approach by exluding many CMS that seem not to fit the criteria. It is somewhat strange that OpenAdvantage cuts away Magnolia because it "Requires J2EE server; difficult to install and configure; more of a framework than CMS", and proceed to include Apache Lenya in the full evaluation. Magnolia does not require a J2EE server. It runs on Tomcat just like Lenya does (maybe it's an idea to bundle Magnolia with Jetty to make it seem more lightweight). I'm still sure that OpenAdvant

What I've Learned After a Month of Podcasting

So, it's been about a month since I launched   GitMinutes , and wow, it's been a fun ride. I have gotten a lot of feedback, and a lot more downloads/listeners than I had expected! Judging the numbers is hard, but a generous estimate is that somewhere around 2000-3000 have listened to the podcast, and about 500-1000 regularly download. Considering that only a percentage of my target audience actively listen to podcasts, these are some pretty good numbers. I've heard that 10% of the general population in the western world regularly listen to podcasts (probably a bit higher percentage among Git users), so I like to think I've reached a big chunk of the Git pros out there. GitMinutes has gathered 110 followers on Twitter, and 63, erm.. circlers on Google+, and it has received 117 +'es! And it's been flattr'ed twice :) Here are some of the things I learned during this last month: Conceptually.. Starting my own sandbox podcast for trying out everythin

Considerations for JavaScript in Modern (2013) Java/Maven Projects

Disclaimer: I'm a Java developer, not a JavaScript developer. This is just what I've picked up the last years plus a little research the last days. It's just a snapshot of my current knowledge and opinions on the day of writing, apt to change over the next weeks/months. We've gone all modern in our web applications, doing MVC on the client side with AngularJS or Ember , building single-page webapps with REST backends. But how are we managing the growing amount of JavaScript in our application? Yeoman 's logo (not necessarily the conclusion of this blog post) You ain't in Kansas anymore So far we've just been doing half-random stuff. We download some version of a library and throw it into our src/main/webapp/js/lib , or we use it from a CDN , which may be down or unreachable when we want to use the application.. Some times the JS is minified, other times it's not. Some times we name the file with version number, other times without. Some

Managing dot-files with vcsh and myrepos

Say I want to get my dot-files out on a new computer. Here's what I do: # install vcsh & myrepos via apt/brew/etc vcsh clone https://github.com/tfnico/config-mr.git mr mr update Done! All dot-files are ready to use and in place. No deploy command, no linking up symlinks to the files . No checking/out in my entire home directory as a Git repository. Yet, all my dot-files are neatly kept in fine-grained repositories, and any changes I make are immediately ready to be committed: config-atom.git     -> ~/.atom/* config-mr.git     -> ~/.mrconfig     -> ~/.config/mr/* config-tmuxinator.git       -> ~/.tmuxinator/* config-vim.git     -> ~/.vimrc     -> ~/.vim/* config-bin.git        -> ~/bin/* config-git.git               -> ~/.gitconfig config-tmux.git       -> ~/.tmux.conf     config-zsh.git     -> ~/.zshrc How can this be? The key here is to use vcsh to keep track of your dot-files, and its partner myrepos/mr for o

Git Stash Blooper (Could not restore untracked files from stash)

The other day I accidentally did a git stash -a , which means it stashes *everything*, including ignored output files (target, build, classes, etc). Ooooops.. What I meant to do was git stash -u , meaning stash modifications plus untracked new files. Anyhows, I ended up with a big fat stash I couldn't get back out. Each time I tried, I got something like this: .../target/temp/dozer.jar already exists, no checkout .../target/temp/core.jar already exists, no checkout .../target/temp/joda-time.jar already exists, no checkout .../target/foo.war already exists, no checkout Could not restore untracked files from stash No matter how I tried checking out different revisions (like the one where I actually made the stash), or using --force, I got the same error. Now these were one of those "keep cool for a second, there's a git way to fix this"situation. I figured: A stash is basically a commit. If we look at my recent commits using   git log --graph --