Slashdot Log In
Put MediaWiki to Work for You
Posted by
ScuttleMonkey
on Sun May 21, 2006 01:41 PM
from the howtos-and-other-meme dept.
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.
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
Does it come with Admin tools? (Score:4, Funny)
(Last Journal: Thursday October 17 2002, @10:28AM)
Crap (Score:5, Insightful)
(http://picknit.com/ | Last Journal: Saturday July 29 2006, @03:58PM)
Re:Crap (Score:5, Insightful)
(http://ohadev.com/)
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.
Because it involves learning a new skillset (Score:5, Insightful)
I concur! (Score:4, Insightful)
Wiki (Score:3, Funny)
(Last Journal: Monday November 12, @01:57AM)
-Grey [wellingtongrey.net]
I can seen this now.. (Score:5, Funny)
I can already see the productivity peaking =) (Score:2, Troll)
(http://vitalyb.wordpress.com/)
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)
I welcome Wikis to my organization (Score:2, Interesting)
Nothing New (Score:2)
(http://snowulf.com/)
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?
If it works for the Peoples Republic of China (Score:1)
(Last Journal: Sunday November 27 2005, @02:29PM)
worked for me (Score:5, Interesting)
(http://www.lightandmatter.com/)
Semantic MediaWiki (Score:3, Informative)
Extensibility of MediaWiki (Score:4, Informative)
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.
Re:Extensibility of MediaWiki (Score:4, Insightful)
(Last Journal: Wednesday March 09 2005, @03:04AM)
However, you're correct. If you plan to change the look or behaviour of it, you are truly out of luck due to the MediaWiki codebase mess.
In action in our tech department... (Score:2, Insightful)
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)
(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)
(http://tuxmobil.org/ | Last Journal: Tuesday March 01 2005, @08:33AM)
Company wikis (Score:4, Interesting)
(Last Journal: Tuesday October 02, @09:54AM)
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)
They work well when people want to share (Score:4, Interesting)
(http://www.slamb.org/)
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...
Installed one last week! (Score:2)
(http://www.craigcmiller.com/)
... Created by KEY people... (Score:1)
Nice try, goddamn taylorist.
Needs better Oracle support (Score:1)
Trying to setup a Wiki for this now! (Score:1)
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)
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.
We've been doing this for about a year (Score:2, Insightful)
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)
(http://stable.cowoh.org/)
Did that at my company... (Score:3, Interesting)
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)
(http://homestarrunner.com/)
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)
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
It works, and it needs FCKEditor (Score:2)
(http://olliver.family.gen.nz | Last Journal: Tuesday October 17 2006, @10:04PM)
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
Lifehacker had something about this... (Score:2)
(Last Journal: Monday July 17 2006, @06:40PM)
I tried this, and it worked quite well.
Which Wiki? (Score:2, Interesting)
(http://asknice.com/)
using it here (Score:2)
(http://crayz.org/)
Some useful add-ons we've used are:
http://bugzilla.wikimedia.org/show_bug.cgi?id=192
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
MediaWiki seems a strange choice for corporate use (Score:4, Insightful)
(http://www.keiretsumusic.com/steve/ | Last Journal: Saturday February 17 2007, @05:51PM)
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)
(http://wikipedistik.de/)
Hopefully this information will be translated to english in the next 1-3 days.
Swiki (Score:1)
(Last Journal: Wednesday July 12 2006, @03:04AM)
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.
unparalleled success (Score:2)
(http://www.wikindex.com/)
- 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.TWiki should be better for a corporate environment (Score:2, Interesting)
(http://supertux.com/)
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.
No standardized markup (Score:2)
Hopefully GUI editors will minimize this problem.
tiddlywiki (Score:2)
(http://www.coolbutuseless.com/ | Last Journal: Friday January 04 2002, @06:51AM)
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)
I wonder if it's related to Morgellons [morgellons.org]?
Just don't use it as a doge for competence. (Score:2)
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)
dokuwiki (Score:1)
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.
I did this using Swiki (Score:2)
(http://users.rcn.com/jonathan02/)
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.
stop the "how to install" padding BS (Score:2)
But it's not Microsoft Word! (Score:2)
Even though Wiki tags are much easier than HTML, they still aren't WYSIWYG, so PHB types would still find them confusing.
Re:Great! I can update the Overtime Policy. (edit) (Score:2)
NEW EDIT - by Employer
Overtime need not be paid out at all, with the employer providing no benefits.
Re:Great! I can update the Overtime Policy. (edit) (Score:2)
(http://brokenhut.livejournal.com/)
Re:Wiki and Work (Score:2)
(Last Journal: Wednesday March 23 2005, @05:01PM)
Re:VA? (Score:2)
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.
Re:Why not bring wiki-benefits to YOUR organizatio (Score:1)