Stories
Slash Boxes
Comments

News for nerds, stuff that matters

Put MediaWiki to Work for You

Posted by ScuttleMonkey on Sun May 21, 2006 01:41 PM
from the howtos-and-other-meme dept.
NewsForge (Also owned by VA) is running a short writeup on how to put MediaWiki to work for your organization. The writeup includes several addition tools that could be helpful in rounding out the overall package. From the article: " Imagine how useful it would be to have an online knowledge base that can easily be updated created by key people within your organization. That's the promise of a wiki -- a Web application that 'allows users to easily add, remove, or otherwise edit all content, very quickly and easily,' as Wikipedia, perhaps the best-known wiki, puts it. Why not bring the benefits of a wiki to your organization?"
This discussion has been archived. No new comments can be posted.
Display Options Threshold:
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
  • by blair1q (305137) on Sunday May 21 2006, @01:46PM (#15376686)
    (Last Journal: Thursday October 17 2002, @10:28AM)
    Because I want to start a cadre of petit bureaucrats who think their subjectivity is objective and your objectivity is subjective.
  • Crap (Score:5, Insightful)

    by fm6 (162816) on Sunday May 21 2006, @01:46PM (#15376693)
    (http://picknit.com/ | Last Journal: Saturday July 29 2006, @03:58PM)
    What a thoroughly useless article! It makes some vague assertions about what a MediaWiki good for, and than just regurgitates installation instructions. How about comparing this Wiki software with its many alternatives? Or even explaining why Wikis are so big?
    • Slashvertisement. by SeaFox (Score:3) Sunday May 21 2006, @01:54PM
    • Re:Crap (Score:5, Insightful)

      by ClassMyAss (976281) on Sunday May 21 2006, @02:23PM (#15376812)
      (http://ohadev.com/)
      I'm not going to argue that for the majority of /. readers this article offers absolutely nothing they don't already know. But the fact is, once you leave the cozy confines of the IT world, your average business-person doesn't have a clue what a Wiki is or why anyone would use one. Since at least some businesses could probably gain quite a bit from this model of collaboration, I do applaud the intentions of the article, even if this isn't necessarily the correct audience to target.

      That said, your average business person stops reading the moment they get to "Next, find the LocalSettings.php file in your wiki directory. Add the following lines: $wgGroupPermissions['*']['createaccount'] = false;..." A better way to word this would have been "Now go find those tech guys you keep in the basement and tell them you want a Wiki."

      Just a thought.
      [ Parent ]
      • Re:Crap by ergo98 (Score:2) Sunday May 21 2006, @03:33PM
    • Keep reading, fm6, how this is a big deal. by twitter (Score:2) Sunday May 21 2006, @02:48PM
    • Re:Crap by FhnuZoag (Score:2) Sunday May 21 2006, @02:53PM
    • Wiki works by Rik van Riel (Score:3) Sunday May 21 2006, @03:24PM
    • Re:Crap by Professor_UNIX (Score:2) Sunday May 21 2006, @04:12PM
      • Re:Crap by jandrese (Score:2) Sunday May 21 2006, @09:11PM
        • Re:Crap by Professor_UNIX (Score:2) Monday May 22 2006, @04:48PM
      • Re:Crap by hunterx11 (Score:3) Sunday May 21 2006, @09:27PM
        • Re:Crap by Professor_UNIX (Score:2) Monday May 22 2006, @04:46PM
    • Re:Crap by Large Green Mallard (Score:2) Sunday May 21 2006, @10:38PM
      • Re:Crap by fm6 (Score:2) Sunday May 21 2006, @10:47PM
        • Seconded. by Ayanami Rei (Score:2) Monday May 22 2006, @09:08AM
          • Re:Seconded. by fm6 (Score:2) Monday May 22 2006, @12:53PM
            • Re:Seconded. by Ayanami Rei (Score:2) Monday May 22 2006, @02:19PM
    • Re:Crap by arodland (Score:2) Monday May 22 2006, @01:45AM
      • Re:Crap by fm6 (Score:2) Monday May 22 2006, @12:45PM
    • Re:Crap by bensch128 (Score:1) Monday May 22 2006, @03:13AM
      • Re:Crap by fm6 (Score:2) Monday May 22 2006, @12:51PM
        • Re:Crap by bensch128 (Score:1) Tuesday May 23 2006, @06:58AM
  • by get quad (917331) on Sunday May 21 2006, @01:47PM (#15376696)
    Learning how to successfully edit a wiki page can be quite easy, however learning to completely manage a wiki and learn all of its editing and layout syntax is another matter altogether.
  • I concur! (Score:4, Insightful)

    by Anonymous Coward on Sunday May 21 2006, @01:50PM (#15376701)
    I work for a large visual effects company, and we have been using this resource for a while now. It is especially helpful when dealing with frequently changing pipelines and procedures, because it provides an easily modifiable up to date resource that can be accessed remotely from any machine on the lot.
  • Wiki (Score:3, Funny)

    by Wellington Grey (942717) on Sunday May 21 2006, @01:51PM (#15376703)
    (Last Journal: Monday November 12, @01:57AM)
    The wiki solution to every problem: add more idiots.

    -Grey [wellingtongrey.net]
  • I can seen this now.. (Score:5, Funny)

    by goldaryn (834427) on Sunday May 21 2006, @01:52PM (#15376706)
    Because of recent vandalism, or to stop banned editors from editing, editing of this page by new or unregistered employees is currently disabled. Please discuss changes on the talk page, or request unprotection. Anyone continuing to propogate stories about the CEO, the monkey and the baby oil will be severly reprimanded.
    • 1 reply beneath your current threshold.
  • So... On one hand people are spending some more time in reading the injokes of their work-buddies but on the other hand, people are consumed by endless edit-wars.
    I can see how helpful it can be for a company.

    Seriously though, a friend of mine actually did install a wiki under the same premises of the article. They are having lots of fun with it, but it hardly helped their workplace.
  • PBH? (Score:1)

    by Anonymous Coward on Sunday May 21 2006, @01:52PM (#15376711)
    I wonder if PHBs would even like this? Many would prefer a system in which info passes through several hierarchies before being published, the idea that anyone can edit and their edits would automatically be viewable would put off many clueless PHBs...
    • Stable versions by tepples (Score:2) Sunday May 21 2006, @03:10PM
    • Re:PBH? by brion (Score:2) Sunday May 21 2006, @05:58PM
  • I welcome Wikis to my organization (Score:2, Interesting)

    by Anonymous Coward on Sunday May 21 2006, @01:53PM (#15376713)
    I welcome Wikis to my organization. We've been using Dokuwiki for past year and it's been a success story. Knowledge is shared in an effective way.
  • I setup a wiki for our small software company a long long time ago. This really isnt anything new. Wiki's are great for documentation, especially with any rapidly changing products.

    Its cool that this idea is put out, but I don't understand why this is such a big deal. It was on newsforge, linked from ITMJ, slashdot too? Yippy?
  • it can work for your company!
  • worked for me (Score:5, Interesting)

    by bcrowell (177657) on Sunday May 21 2006, @02:03PM (#15376747)
    (http://www.lightandmatter.com/)
    It worked for me. I teach physics at a community college, and our physics stockroom has hundreds of pieces of equipment that we need to keep a catalog of. The solution we tried before was that the lab technician kept the catalog in an MS Excel spreadsheet. The problem with that was that if someone other than the lab tech wanted to add something to the catalog, or document the fact that they'd moved it, there was no easy way to do it. Also, the only way to get access to the latest version of the catalog was to ask the tech for the latest (paper or electronic) copy. None of this worked very well, for example, in night classes when she wasn't there. I converted the catalog to a wiki, and I think it's worked fairly well. Nobody in the department was familiar with the concept, so they needed a little hand-holding. But even people who aren't comfortable with editing a wiki can at least understand that there's this web address they need to go to in order to find a piece of equipment.
  • Semantic MediaWiki (Score:3, Informative)

    by GerardM (535367) on Sunday May 21 2006, @02:05PM (#15376750)
    When the public for a MediaWiki installation is not too big, a must have extra is the Semantic MediaWiki. It really helps in making content rich and when using it in an environment for more organisational knowledge sharing, it is one of the best extras you can find. Thanks, GerardM
  • Extensibility of MediaWiki (Score:4, Informative)

    by Anonymous Coward on Sunday May 21 2006, @02:06PM (#15376761)
    MediaWiki may be fine, until you decide you want to extend it or maintain it. Take a look at the code! Spaghetti PHP mixed with spaghetti HTML mixed with spaghetti SQL, spread in an even layer everywhere throughout the system.

    Don't expect to be able to extend or modify it easily. I've come to the conclusion that it would be easier to reimplement it than to modify it.

  • In action in our tech department... (Score:2, Insightful)

    by cronostitan (573676) on Sunday May 21 2006, @02:11PM (#15376776)
    We are using Mediawiki as documentation system to document all our servers, procedure and contacts within the tecnical departemnt. Since I am an open source advocate I introduced the system in 2003 and from there it only grew. Although you have to keep a look at it and do a re-structure from time-to-time to adjust to the amount of information it has been proven to be very useful. The only thing i am really missing is a good admin structure where it would be easy to configure a closed user group of editors since we would like to keep passwords and things like that in the Wiki too.

    On the other hand an alternative would be a good password sharing solution. It should be safe and very strict in how I share password with other people using teh same too. Does anyone have a good solution to this problem?
  • What's going on here...? (Score:4, Insightful)

    by WWWWolf (2428) <wwwwolf@iki.fi> on Sunday May 21 2006, @02:13PM (#15376781)
    (http://www.iki.fi/wwwwolf/)

    I'm not a MW guru, but does the article's idea of <PHP> tag really do what I think it does?

    As in "raw code in a a place where people can edit it?"

    Doesn't matter they are trying to limit the wiki's edit access only to registered users - this is wrong.

    Ugh. You know, one of the reasons why I like MediaWiki is that it does well with separating the page code from the HTML. And now these people want to sprinkle random PHP crap in the pages again. Argh.

    And as an additional bonus, you get to store your mysql_connect() parameters to the page source. Whee. Realllly smart.

    Somebody please submit this to TheDailyWTF...

    The real way to do this is to write a MediaWiki extension, of course (look at ParseFunctions for an example of something simple), which is then accessed through the usual hooks, like {{foo:...}}, but don't ask me, I don't know that much about MW's internal structure. I just know bad ideas when I see them. =)

  • How to compare Wikis (Score:5, Informative)

    There are many different Wikis available. All with different pros and cons. To compare them all is the aim of the WikiMatrix [wikimatrix.org] project. If you are not sure which Wiki is best for you, WikiMatrix offers a Wiki choice wizard.
  • Company wikis (Score:4, Interesting)

    by allenw (33234) on Sunday May 21 2006, @02:24PM (#15376814)
    (Last Journal: Tuesday October 02, @09:54AM)
    Most of the experiences I've had with wikis inside our corporate environment have been mixed. A lof of folks (techie or otherwise) treat it more like a generic CMS rather than a hyperactive hyperlinking system. When they create a page, they make the assumption that it is their private page... so we end with page names like "Status". A lot of time is spent cleaning these up or the wiki becomes full of potholes.

    Sure, user education would help here, but there is only so much one can do... especially in a company of 30,000+ users.

    While wikis certainly lower the bar for producing web content, there really needs to be some sort of way to prevent users from doing things that they don't particularly realize are (overall) harmful. Or at least much better training tools.

  • Wikis are evil (Score:5, Interesting)

    by PietjeJantje (917584) on Sunday May 21 2006, @02:27PM (#15376828)
    I like wikepedia, but I don't like wikis. Your "knowledge base" is your web site or documentation section. If you add a wiki, I have two places to search for information, do I have to look in the docs, or in the chaotic wiki, where you won't be able to find it anyay? Wikis seem an excuse for laziness, just throw the information somewhere instead of making a structured, well designed web site or documentation section.
  • by slamb (119285) * on Sunday May 21 2006, @02:33PM (#15376842)
    (http://www.slamb.org/)
    My company has a successful MediaWiki installation, and I love it. All our technical teams (engineering, QA, system administration) are using it.

    I've put into it design documentation, instructions for accessing our other services (e.g. Subversion repositories), troubleshooting tips, sequence diagrams of various race conditions, you name it. I try to periodically dump everything in my notes directory into the wiki. The effort of cleaning it up means I'll understand it later, having it on the wiki server means it's backed up regularly, and as a bonus, other people see it and don't need to ask me as many questions, so I can spend more time developing. And it gives people a way to still get answers when I'm off bicycling through Africa.

    But collaboration technology like MediaWiki or bugzilla only works when people use it. There are always some people who won't play with others. If I put information on the wiki, they'll come bug me for it anyway. If I tell them it's on the wiki, they still won't read it. If I give them information verbally and specifically ask them to put it on the wiki, they won't do it. And then they wonder why I ignore their emails...

  • by iJed (594606) on Sunday May 21 2006, @02:36PM (#15376852)
    (http://www.craigcmiller.com/)
    I actually installed MediaWiki last week as an attempt to get documentation moved off the dreadful pile of crap that is Lotus Notes. Its amazing how quickly useful content has been added to this since the documentation on Lotus Notes is updated so infrequently. The difference is that Lotus Notes is not very easy to use and MediWiki content is a simple search away.
  • by rvalles (649635) <rvalles&es,gnu,org> on Sunday May 21 2006, @02:44PM (#15376871)
    By key people... so everybody else are idiots and don't have anything to say, huh?

    Nice try, goddamn taylorist.

  • by guice (907163) on Sunday May 21 2006, @02:48PM (#15376888)
    Wiki not gonna hit main stream in cooperations until the Oracle support is streamlined. I have a version at work I got about a month or two ago that has issues with the basic install using Oracle. One mistake and you have to DROP everything it created (providing you can actually figure out what it created). Hasn't MediaWiki dev folks herd of "CREATE OR REPLACE?"
  • by 6079 - Winston S (933883) on Sunday May 21 2006, @02:53PM (#15376904)
    I've volunteered for to setup a Wiki for a CRM we use, but the admin is not clear.
    It would be real helpful to have a Wiki-template or importer tools.

    How do I move CHM/html docs into Wiki? I want to search the manual.
    How do I backup the database? (yeah. dump the db but where's the GUI?)
    If I use GNU documentation licence, why doesn't the wiki populate it, or any how-to-wiki articles?

    How do I easily set up Catagories, without modified each and every page?
    I've read the mediawiki guide, and asked the CHM/DB question in the IRC forums.. to no avail.
  • Mixed results with our intranet wiki (Score:5, Interesting)

    by ewg (158266) on Sunday May 21 2006, @03:14PM (#15376962)
    Our management wanted an "intranet" a few years back but had zero budget. My answer was JSPWiki [jspwiki.org] on a Linux box.

    The wiki has succeeded in a couple of notable areas. The photo directory page is critical for learning new faces on a rapidly growing staff. Another page has completely replaced sticky-notes that were formerly used to coordinate certain tasks among staff and interns. The IT department has a lot of miscellaneous documentation pages. A few other pages serve the function of an electronic bulletin board for staff scattered across two buildings.

    Management was very concerned at first that staff would abuse the wiki, either by wasting time posting trivia or by outright vandalism. Neither fear has materialized.

    The biggest failure of the wiki is the number of abandoned pages. They don't do any harm, but about a third of pages are derelict, with old information that the author obviously lost interest in maintaining. Having a wiki editor might solve that problem, but in practice it doesn't rise to the level.
  • by simon_hibbs2 (792812) on Sunday May 21 2006, @03:30PM (#15377027)
    I found Mediawiki pretty easy to set up. I used XAMPP http://www.apachefriends.org/en/xampp.html [apachefriends.org] for the Apache/MySQL/PHP layer as it's an internal project on our LAN so security wasn't a major concern.

    It's a huge improvement on any previous method we've used to organise our documentation - mostly FAQs, instructions, process documentation, links to external resources, screenshots, all sorts. Apart from backups (VBSCript to take a MYSQL dump and copy the images directory), I use HTTrack to take a 1 link deep HTML snapshot of the 'Special:AllPages' page. This can be copied to a laptop or flash drive for offline reference. The wiki pages cut-n-paste into word nicely too.

    I've recently come across TiddlyWiki, which is very nice. I'd consider that for any future small scale projects.

    Simon Hibbs

  • Does it come with a wafer? (Score:3, Interesting)

    by The OPTiCIAN (8190) on Sunday May 21 2006, @03:31PM (#15377029)
    (http://stable.cowoh.org/)
    I'm a wiki skeptic. It works fine on a large scale like wikipedia, but smalls-scale wikis - such as in your office - tend to be rubbish. Nobody has ownership over content and they suffer from the tragedy of the commons. I think it's probably more effective to use a blog for lots of internal communication, and then probably some sort of CMS-with-comments where you need a graph of pages.
  • Did that at my company... (Score:3, Interesting)

    by NeutronCowboy (896098) on Sunday May 21 2006, @03:50PM (#15377100)
    ... and I consider it one of the best things I've done there.

    The situation we used to work in was that we had a lot of customer information that changed quickly, a group of engineers who worked disparate hours (there was supposed to be someone available between 7AM and Midnight) and documentation that was scattered all over. We had a central repository for documentation, but it was the pits. You could only search on key words or categories, check-out and check-in procedures were laborious, if not counter-productive, and everything had to go through an approval cycle. Finally (and that, combined with the fact the repository was unsearchable, was kinda the nail in its coffin), reviews were partially based on how many entries you'd submit. The end result was an essentially unsearchable repository was filled to the bring with duplicate entries and outdated stuff.

    Fed up with that, we created a Wiki on the side project. Initially I filled it myself with random things that I found useful. Then other people started using it. It wasn't perfect, but it was loads better than what we had - we could actually find information! Outdated stuff could be updated. People didn't have to call others at all hours of the night for server information anymore. And best of all, new hires could be pointed to it, and they could find useful starting information.

    To give you an idea of how successful it was, it was initially completely disallowed by management, as it was creating a duplicate information store. The desktop server on which it was stored was yanked. But it stuck around, because people actually used it. Now, the entire group uses it for storing training, server, contact or any other information that a lot of people need and that changes often. Contrary to the commercial data storage software, it helps us do our job more efficiently.

    Wikis are undeniably useful and loads better than anything else out there - if you make sure that the information you try to make accessible falls in the following categories:
    - lots of different people can use it
    - changes often
    - lots of people can contribute to it

    Oh, and it also helps if people aren't dicks, to use Wikipedia's rule.
  • PSU (Score:2)

    by finkployd (12902) on Sunday May 21 2006, @04:08PM (#15377150)
    (http://homestarrunner.com/)
    We have used mediawiki in my department (Emerging Technologies) at PSU and it has been a great success. There is some features to be desired that we had to modify it to handle. Specifically, using an external authentication system (we already have University wide accounts through Kerberos and our web single sign on system thanks, don't need another one) and some form of access controls would be nice, but overall it is great.

    However, you really need to work with people who already are used to collaborating in general. A wiki is not going to change anything if the people you work with don't already work together on stuff. Interestingly, our "killer" use so far for it has been the yearly report, which is generally a huge document that everyone contributes little bits and pieces to. That seems to be the best use case for a wiki.

    Finkployd
  • Coursebook replacement (Score:2, Interesting)

    by zolltron (863074) on Sunday May 21 2006, @05:04PM (#15377306)
    At our university we have several different instructors teaching a series of logic courses. Currently, each instructor uses their own favorite notes and textbooks. This means that what students learn in in one class is different from what is used in the very next course in the series. We also have several different instructors for the same course, each develops her own course materials. It's a mess.

    We have started using a wiki to cooperatively develop materials for this course. We hope that it will eventually replace the text books. People are excited because no one is giving up control of *their* course, but at the same time, we don't duplicate efforts and people are forced to resolve their differences when it comes to presentation.

    -z
  • We've used the Wiki for a while now at ECONZ http://econz.com/ [econz.com] and it has been very useful. All it needs is someone to take control of the formatting of the site, rather than just leaving everything totally free range. The one remaining problem is the actual editing process, which MS Word users can't seem to get their heads around.

    We did find FCKEditor http://www.fckeditor.net/ [fckeditor.net] but that doesn't come built-in and support is beta. Mention that to the system admins, and they'll refuse to install it. Once that gets integrated, we'll be able to get even more of the staff using it.

    Vik :v)
  • I believe Lifehacker had an article showing you how to set up a MediaWiki on a Windows machine [lifehacker.com].
    I tried this, and it worked quite well.
  • Which Wiki? (Score:2, Interesting)

    by dugjohnson (920519) on Sunday May 21 2006, @05:46PM (#15377417)
    (http://asknice.com/)
    I finally (last week) got a go ahead on a Wiki which I have been playing with, but couldn't get anyone else on the sub-group to play (on the road, not enough time, yada yada) to at least stick one on the new intranet. I was working with MediaWiki, but their install readme says it is more for Unix/Linux and this is a strictly Windows house. I think it oughta work on the Windows server, but haven't set it up there, and wondered if there is any recommendations amongst the /.ers of a Wiki that will be easy to setup and easy to use. For our purposes, almost anything is a step in the right direction, but I am not the one who will be doing the full install, merely assisting he who maintains it all.
  • using it here (Score:2)

    by crayz (1056) on Sunday May 21 2006, @05:48PM (#15377419)
    (http://crayz.org/)
    We're using an in-house MediaWiki knowledge-base system here. It's been running for over a year and is a huge step forward from the previous setup we had(which was developed in-house in CF). The hardest part was writing code to export/parse/import from the old system to MediaWiki. Once that was done it's been smooth sailing

    Some useful add-ons we've used are:
    http://bugzilla.wikimedia.org/show_bug.cgi?id=1924 [wikimedia.org] (a patch to have restrictions of namespaces to certain groups)
    http://bugzilla.wikimedia.org/show_bug.cgi?id=814 [wikimedia.org] (LDAP/ActiveDirectory authentication plugin)

    It's a great example of a good open source tool beating the hell out of one-off systems developed out of a not-invented-here mentality
  • I'm involved in the team implementing a new intranet (or extranet I suppose, it's international) for my organisation. A few months ago I wrote quite a lengthy paper extolling the virtues of Wiki and it's possible applications in the corporate world, for which I did a little research into MediaWiki and it's many alternatives (see also: the WikiMatrix link posted above).

    Now, I may be wrong, (and I welcome corrections if so), but from what I gathered, MediaWiki has poor-to-nonexistent support for advanced granularity of permissions. Essentially, everything is editable by everyone. Beyond that, there is a very simple level of control inasmuch as admins can lock a page and whatnot. But setting up a system whereby users come out of AD/LDAP and can edit (or not) different areas corresponding to their department/group, or setting up workflow systems where (for example) anyone can edit but it must be approved by a departmental admin (who can act as admin within their department's pages, but not elsewhere) before showing up... It didn't look as if any of this was possible.

    Furthermore, I was told there's no point even asking for it. Because such things don't gel with the Wikipedia philosophy, the people spending their time coding MediaWiki simply aren't interested in implementing them. (Don't get me wrong, I'm not whinging about this - naturally they should devote their time to features which actually suit their demands, not somebody else's).

    So it seems to me very odd to promote MediaWiki for the corporation, when other systems have much more sophisticated ACL-type features, granular permissions, and so on.

    Comments welcome?

    (PS. FWIW, we eventually settled on Plone. Plone does have a Wiki plugin so if we ever do use Wiki's I guess we'll use that. But I'm still evaluating which Wiki system to use for a separate project, outside work, but which still requires more advanced editing permission granularity. DokuWiki seemed the best fit, with the one problem that it uses flat files for storage, and our sysamin would prefer a db backend as they have a dedicated db box, so it'd be quicker. WikiMatrix narrowed it down to ErfurtWiki, Midgard Wiki, miniWiki, PhpWiki, TikiWiki, WackoWiki and Wiclear: out of these, I didn't like the look of phpWiki for some reason I can't remember right now, and I've never even heard of the others. If anyone has any experience with any of these systems, please do share :) )

  • Wikis in Enterprises (Score:2, Informative)

    You can find information and a survey (in German!) about Wikis in Enterprises here: http://wikipedistik.de/umfrage/ [wikipedistik.de]

    Hopefully this information will be translated to english in the next 1-3 days.
  • Swiki (Score:1)

    by erexx23 (935832) on Sunday May 21 2006, @06:52PM (#15377582)
    (Last Journal: Wednesday July 12 2006, @03:04AM)
    I have used a Swiki (Squeak Wiki) for the last 4 years to organize IT/IS information.
    While it is a fantastic resource from an organizational standpoint for many reasons,
    In my experience it works as good as your people's incentive to input the information.
    Ownership of information like "HowTo's" are an issue with some technical employees.
     
  • As I told newsforge a few months back, we have seen unparalleled success with deploying MediaWiki at our company [backcountry.com] as an intranet. What started 13 months ago as a quick way to get an intranet up and running has now blossomed into a vibrat communications channel with over 7000 pages, all written by our employees. It has become the defacto home for development specs, engineering and network documentation, vendor notes, product notes, warehouse processes, call center training, etc. Some things I've learned:
    • do NOT allow MSWord or other complex documents to be uploaded as attachments-- it destroys the point of interactive communication
    • train, train, and train some more. I am talking about a lot of coaching to get people through their first additions and edits. Once they 'get it', they'll be hooked.
    • you will not be loved for the first while: everytime you get an attached Word or OpenOffice document, reply back to the person with "thanks, but why didn't you just put this on the wiki?" or "Thanks, please see my response/corrections/additions on the wiki". This pisses people off, because they are used to email ping-pong, but eventually they'll come around.
    • you will not be loved by anyone who is feudal or territorial with "their" project or "their" process. Your choices are to train them, or when that fails, fire them (no, seriously).
    If you can get critical mass going, you will be amazed at the results: email attachments almost evaporate, communication and overall awareness increase, the org flattens out a bit, innovation comes from anywhere, and development time is shortened.
  • by supertux (608589) * on Sunday May 21 2006, @07:34PM (#15377685)
    (http://supertux.com/)
    I realize that mediawiki is the current myspace of wikis, but it is not really ment to be deployed in a corporate environment. Most corporations would need to use a wiki with more access controls like TWiki or confluence.

    I've heard that a while ago, some folks inside Intel set up a mediawiki site for internal documentation, and when the lawyers heard about it, they had the project shut down. There was too much liability I gather.

    Anyway, I've set up a TWiki installation at my work three years ago now and am not totally sure if I would call the project a success story.

    First off, in order for management to buy in, we needed to demostrate that we could lock down sections and properly secure the site. With TWiki it was easy to create 'Webs' with different access permissions.

    Second, in order to get users to buy in, we needed a reason for them to go to the site. For example, they go to the site and find useful content, and so therefore get an idea that the wiki is useful for them. When starting out, there is no useful content in a wiki. Two or three of us have been dutifully putting in what we know into the site, but it has taken maybe two years of effort before there is enough content for other people to find the site semi worthwhile.

    It would be better if everyone just 'got it' and contributed to the site right away.

    Another issue is the employees that know a lot but like to horde information. Having a nice collaboration tool around will not get them to release nugets of information they certainly have.

    Some people insist on publishing perfect documents to the wiki. Those kinds of documents are nearly impossible to come up with on the first pass, and so a lot of documentation that is partially captured and written up has never made it to the site. I'm sure this issue is partly my fault as I haven't impressed upon the users that it is ok ot put up half ass content into a wiki, and then work on it later to polish it up if it would be useful.

    One more problem we've had is that most of the employees think that documents in the wiki are owned by the creator of the document and not to be touched by them. I know I have explained about colaboration and cooperative editing a lot, but still, most people will not fix minor errors in documents created by other people. I have had people come up to me and tell me that there is an error in a document I've written in the wiki, or some have sent me emails telling me so. I have demonstrated that they should have edited the page themselves and fixed the error, and now a few of my fellow employees are more willing to do that.

    Anyway, even dispite all of these hardships and difficulties, I think the wiki installation is invaluable, and at least for the few of us that 'get it' with regards to wikis, the site has made us maybe 20-30% more productive then we were before we had it around.
  • by DrDitto (962751) on Sunday May 21 2006, @09:28PM (#15377964)
    The problem with Wikis is the lack of a standardized markup language. They all differ in subtle ways. This is fine if you only use one, but I use several.

    Hopefully GUI editors will minimize this problem.
  • tiddlywiki (Score:2)

    by mikecheng (3359) on Sunday May 21 2006, @10:16PM (#15378072)
    (http://www.coolbutuseless.com/ | Last Journal: Friday January 04 2002, @06:51AM)
    I futzed with a few wikis to try and orgnise all the disparate parts of my life (which were usually recorded on a swarm of post-it notes). My main problems were having to setup/admin a httpd server on which to run the wiki, and then backing up/restoring the information in the wiki.

    Eventually I found tiddlywiki [tiddlywiki.com].
    Pros:
    * no httpd required
    * all information stored in a single html file (including the wiki code itself!)
    * has tags and a search function
    * monstrously quick and easy to set up.

    Cons:
    * haven't found anything about it I don't like yet.

    I've now torn down every postit from my wall - if it needs recording, it gets stuck it the wiki (a process that takes less than a minute).
  • Wikiphilia (Score:2)

    by whorfin (686885) on Sunday May 21 2006, @11:05PM (#15378243)
    Submitter has a bad case of Wikiphilia [hacknot.info].

    I wonder if it's related to Morgellons [morgellons.org]?
  • by Zadaz (950521) on Sunday May 21 2006, @11:41PM (#15378347)
    Imagine how useful it would be to have an online knowledge base that can easily be updated created by key people within your organization.
    Probably written by someone who hasn't thought about it or tried it. In my experience Wiki's have the same fault of most other "management" software. Unless people must use it, it's a waste of time.

    It's not typically the software's fault, it's the people. Managers are lazy/busy and resistant to change. Frankly most of them don't have the skill to organize a wiki properly. And the people who have the information to populate the wiki... well, why would they?

    Knowledge bases are documentation. Who reads documentation? No one. I regularly spend more time writing documentation than people will ever spend reading it. (But it's in the contract and easy money.) If I'm an average Joe with a question, I'll just email someone. It's faster (for me) and, after the first few times I go through the project's wiki, try to navigate through it and fail to find what I'm after, I'm likely to never use it again. And forget about the people with the actual knowledge actually spending time to dump useful information in the thing. They might, after getting enough emails on the same question, but that's a FAQ list, not worth a wiki.

    Three recent projects I've worked near have all had wikis. And each one (Project and wiki) is a huge mess. I'd wager problem is the project manager, thinking the wiki is going to manage the project for them, when what it really does is give them more work. After complaining about the state of the wiki's, a new project they offered me control of the wiki. I said, "OK" and deleted it. A few people complained, but in the end they couldn't use the "Oh, it's in the wiki" as a distracting excuse any more and the project (so far) is closer to budget and time than the others. (Still got that lame PM, but oh well.)

    The people who want the wiki's are the same people who love "documenting" code with NaturalDocs. I went through their docs and out of over 500 functions and classes, only three were documented more than "Function: ConvertNumberToDollars (Converts numbers to dollars)". Wow. What a great use of everyone's time and resources that was.

    I'm not saying it can't be helpful, it simply magnifies your management's skills--good or bad. And we all know how rampant bad management is...

  • Wikis (Score:1, Insightful)

    by Anonymous Coward on Monday May 22 2006, @01:23AM (#15378583)
    Why does the article specifically focus on Mediawiki? As other people have pointed out, there are many wikis out there, some of which are faster and easier to use for certain purposes than Mediawiki. I myself run Dokuwiki on my website because it is enough for my needs and runs at a reasonable speed, unlike Mediawiki... I'm not saying that we should have an indepth review of all the different wikis in the article, but just saying "wiki software" rather than "Mediawiki software" doesn't seem too hard.
  • dokuwiki (Score:1)

    by dJOEK (66178) on Monday May 22 2006, @02:03AM (#15378660)
    We use dokuwiki here (http://wiki.splitbrain.org/ [splitbrain.org])

    Although it might not be as featureful as MediaWiki, which imho is a behemoth, it has one key advantage: it Stores your pages in plaintext files, so that if you lose your webserver, php, whatever, you have still access to your stored info. very useful if you're a company that has to worry about DRP

    It's also a breeze to setup and customize. MediaWiki seems to require a ponytail, pizzastained t-shirt and sandals.
  • by Thag (8436) on Monday May 22 2006, @07:53AM (#15379436)
    (http://users.rcn.com/jonathan02/)
    In my previous job, I set up a knowledge base for our Product Support team using Swiki.

    It replaced their previous knowledge base, which was done as a WinHelp file using RoboHELP, and as a result was never updated, because it was a PITA to do, and only a couple people knew RoboHELP.

    Swiki was a lot easier to teach and use, could be set up to run as an automatically-started service on our Windows server, and has all the basic functionality we needed. It can also maintain multiple different Wikis, and can export the contents of the wiki to very nice clean HTML.

    http://minnow.cc.gatech.edu/swiki [gatech.edu]Swiki wiki is here.
  • by wobblie (191824) on Monday May 22 2006, @08:01AM (#15379492)
    It seems like every How-To, indeed every article, review, report or book on open-source-anything whatsoever is at least 90% of "how to download and install foo." If you're really lucky an the author will spend a dozen or so pages on how to download and install the what-have-you on every sort of unix ever created. WHO CARES? Why does every author include such worthless padding in their articles? Even most published books on Free Software spend several chapters regurgitating the README and INSTALL files contained in the source (O'Reilly is one of the worst offenders). This is crap. It is a waste of my time. Please spend some time learning how to write engaging & useful articles, and join me in declaring a 10 year moratorium on redundant horsecrap about how to compile and install software.
  • by AaronLawrence (600990) * on Monday May 22 2006, @08:03AM (#15379510)
    All those people you would like to contribute will refuse to use it because it's not microsoft word.

    Even though Wiki tags are much easier than HTML, they still aren't WYSIWYG, so PHB types would still find them confusing.

  • NEW EDIT - by Employer

    Overtime need not be paid out at all, with the employer providing no benefits.
    [ Parent ]
    • Vandal! by tepples (Score:1) Sunday May 21 2006, @03:29PM
  • - nude masseuse.
    + nude masseur.
    [ Parent ]
  • Re:Wiki and Work (Score:2)

    by Dante (3418) on Sunday May 21 2006, @03:11PM (#15376951)
    (Last Journal: Wednesday March 23 2005, @05:01PM)
    I've got acl support and db support in moinmoin check moin out.
    [ Parent ]
  • Re:VA? (Score:2)

    by bj8rn (583532) on Sunday May 21 2006, @04:05PM (#15377143)
    VA is VA Software [vasoftware.com].

    Slashdot is a part of/owned by OSTG, which is owned by VA Software. They used to state that this or that site was a part of the OSTG, but now, it seems that the VA (which, IIRC, stands for 'Value Added') brand has been brought back from the dead.

    [ Parent ]
  • That site is about Wikipedia, not Wikis in general.
    [ Parent ]
  • 6 replies beneath your current threshold.