Slashdot Mirror
Knowledge Management for an IT Department?
Laurentiu asks: "In every IT department out there there's a wealth of heterogenous information floating around: code snippets, HOWTOs, FAQs, docs, spreadsheets, post-it notes etc. Asking Joe where he put that file won't work forever. So what is, in your experience, a good way to manage this knowledge? And what software would you recommend for such a task?"
Software: moin-moin http://moinmoin.wikiwikiweb.de/. It worked well enough, easy to install, and it was easy to set up credentials and permissions for groups on the diretory and page level for editing and even visibility. It's easy to get in and make simple changes to the code and there's a bunch of modules available of varying quality, though.
Funny anecdote, our group's manager pulled a Lundberg: "I uhh like the program and it works well, but is there a WYSIWYG editor for it?" [Although somewhat idiosyncratic, Wiki markup is trivial to learn and use, HTML looks like C++ in comparison.]
ACHTUNG! Das computermachine ist nicht fuer gefingerpoken und mittengrabben. Ist nicht fuer gewerken bei das dumpkopfen.
I always liked the idea of simple ascii commentary on ideas. and if you need to refer to something, well, use a link - people will 'get' that even if their ascii browsers don't.
I started in vax/vms with 'vaxnotes' and there was the notion of a base topic and its replies. it was simple, but it held the knowledge of DEC in a reasonable fashion, for many people, for many years.
then in the unix world, there was nntp/usenet. same basic idea. and also ascii-based. it scaled well and it worked well (and was well understood and simple enough to manage).
its worth considering. you can enable 'news' on linux boxes as clients (browsers) and servers. people can add (and edit and delete) content and its simple, free and best of all, it works.
--
"It is now safe to switch off your computer."
After taking over the developement for a telemarketing application, with no prior documentation, I immediately started a Wiki using OpenWIKI (they lean towards Microsoft servers for their stuff, so a basic IIS installation is all I had to work with), I convinced the admin guy to give me web space on it plus their SQL server, installed it and started entering everything I came across as I was either fixing or adding stuff. After about 3 months pretty much the entire system was documented to some degree, from the UI to nearly every technical aspect. Then, one of the execs found it, figured out how to add stuff, and now 8 months later it's probably 25% my stuff, and 75% is now full of up to date company practice and communication.
Task Mangler
My favorite: http://www.atlassian.com/software/confluence/
Confluence is just software ($4K + $2k/year); no hardware or hosting.
From the founders of Excite: http://www.jotspot.com/
Jotspot sells hosting w/ SSL ($9-$250/month) or remotely maintained appliances ($10K-$15K/year); no software.
BusinessWeek's choice: http://www.socialtext.com/
Socialtext sells software and hardware but no hosting (Can't remember the price range right now).
You might also want to look into search appliances such as Google's enterprise stuff:
http://www.google.com/enterprise/
...I have been thinking about this alot where I work...or current knowledge managment solution...well in a word SUCKS! Whatever you do stay away from Peregrine(hp soon) Get.Answers....
I have done a basica architecting of a solution that I think would work excellently. Its all based off a Google Search appliance...dump the docs in a few directories tell the Mini google to go to town....
Now users can google for what they need!
Power Corrupts,Absolute Power Corrupts Absolutely, leaving one person(group)in charge is absolutely corrupt.
(1)ditch microsoft office & outlook
(2)make everything visible
(3)make everything shareable
(4)taxonomy is knowledge glue
I just did this for all new projects, the solution is Drupal. Every project and sizeable task gets a chunk of taxonomy then you can catch the conversations in blogs, forums, wherever. All new, popular and recommended stuff is shown on a personal front page modelled on the DC.GOV website. All of this is also RSSified so it can go anywhere and be seen on a cellphone. There's a lot of information but also space for showing feeds & inboxes.
Taxonomy takes a bit of work but tagging actually helps build and refine it. Over six months it will stabilize.
WebOffice All 'documents' should now be written online - either with Writely or the drupal bookmodule. They can be seen, co-edited and generally shared. All drupal mods are wikified. Any text that is proprietary or cannot be written online is a knowledge prison.
Old docs - Knowledge Tree'll hold the old ones
DK
I must de-lurk for this topic.
/ 1974/04/10/31-restrict-pages-under-mediawiki is a good page on how to restrict certain pages in MediaWiki. There is only one level of restriction though - the page is either restricted, or it isn't. To my joy I also discovered that while restriced pages also get indexed for searching, they do not show up among the search results if the user is not on the restricted level himself.
My company is currently centralizing all of its IT functions from the 42 Europe-wide sites it has. Knowledge management is a nightmare, as the institutional knowledge is spread too thin among the old timers to make any impact for the new people. We have some processes documented, but by far not all of them. We decided we needed a written repository of knowledge, as we are growin at a rate where we can not afford to waste time.
We finally decided on MediaWiki, just like some of the others here have suggested, for pretty much the same reasons. It is just great for unstructured information, and the ability to categorize and very quickly link to other pages has turned out to be very useful. It is very quick to update - no need to muck around with HTML and uploading a page. Just hit Edit, change that IP from 223 to 23, click Save and you're set.
Converting existing Word documents to wiki format is essential for quickly populating the wiki with content. We have a lot of support documents with screenshots. I found out that the best way to do that is to save the Word file as HTML. It will export the images both as JPEGs and PNGs. The PNG is the image as it was imported into Word, at its native resolution, while the JPEG is a result of how it has been processed within Word itself (cropped / framed / recolored). I generally just grab the PNGs, unless the cropping was significant, as the JPEG resolution is fairly low. As for the text, I just grab the plain text from the document and mark it up with wikicode. Fairly painless.
Additionally, I also found a nice tool for converting Excel tables into wikicode, for all those worksheets with server IPs, domain functions and other stuff. Save your Excel as CSV then fire up the converter at http://area23.brightbyte.de/csv2wp.php. Just copy-paste (or upload), and presto! You have a nice wiki table. You can then mark it up with colors and other bling-bling if required. Again, I found the process to be relatively fast and painless.
Keeping with the wiki way, the majority of our pages have unrestricted access. Since I'm not a great believer in security through obscurity, we needed something to protect sensitive information - mostly passwords. The privileged few that need to know can get bumped to a higher security level and access these restricted pages.
http://conseil-recherche-innovation.net/index.php
By the way, I full agree with the parent - the wiki by itself is not enough, you do need a librarian / knowledge manager to categorize all the braindumps and also to educate people on its mere existence. I also found that you need to pour a certain amount of info into the wiki before it reaches critical mass and people start to really use it. You do need to work a lot on it, especially in the early stages, with importing content. We didn't bother with scope definitions and categories and stuff - since all of this is so easy to change once the data is up, we'll just build it as we go along.