How do you do in-company documentation (enterprise wiki)? | Hacker News Reader

How do you do in-company documentation (enterprise wiki)?

11 pointssam26 comments

I'm looking for some open source wiki software to do internal documentation for software, hardware, procedures, etc.

A google search for "open source enterprise wiki" returns Twiki and Socialtext. I also stumbled upon TeamPage. I poked around with Socialtext and I like that is a hosted solution (less admin and maintenance for us). Has anyone used any of these offerings or does anyone have any other suggestions?

View on HN

We've implemented plain old MediaWiki in our division. It serves as a document and guidance distribution point to the wider corporate public, as well as an scratch pad for internal procedures and process. Due to the general lack of fine-grained access control and segmentation, we stood up two instances: one for the "public" site without authentication for read-only access (and mediawiki accounts for division members only to edit content) and another one for the "private" site with HTTP authentication for the wiki root.

We use MediaWiki, it works for us just fine

Yep mediawiki is great, exports xml. We integrated this into madcap flare and our build. Published (goes to customers) chm, pdf and webhelp takes the latest snapshot and merges it in, internal users can grab the latest by browsing the wiki.

We have a backing internal discussion board for people to discuss training/presales/help and the like which is good for identifying gaps in the doco as well.

Yeah, avoid TWiki like the plague. Horrible tool.

What's most important in an enterprise wiki is the search feature, so be prepared to use a 3rd party tool for search.

My small team (two network people, one sysadmin, two devs, one manager) gets a lot of mileage out of DokuWiki for project and systems documentation. It's fast, has good plug-ins, and stores pages in the filesystem, which we consider a plus because it makes backups and versioning a snap.

When we're collaborating with larger groups, though, we tend to pick Redmine by default. It offers a nice combination of ticketing, project management, and documentation features, without the learning curve of a traditional wiki or the deployment headaches of something like Confluence.

I see a lot of people bashing Confluence here.. may I ask why? Having used Twiki, DocuWiki, MediaWiki, and now Confluence; it has become my enterprise wiki of choice. If you can get over its J2EE requirements which make for a huge PITA when the time to upgrade to the next version or make it work with other J2EE applications on the same Tomcat instance, it's a pretty productive tool. It gets the job done, its straight-forward to use, and performs quite good. Can I ask why there are a lot of disenchanted Confluence users out there?

Our install of Confluence is dog slow and gives a lot of Internal Server Errors - granted that is probably because whoever set it up has done so badly and on inadequate hardware.

Its WYSIWYG editor annoys me quite a bit, and I find its Markup a bit clunky.

I guess my distaste for Confluence comes mostly from the slowness, which is probably not Confluence's fault. Also, editing pages on my Trac install is so much more pleasant.

Twiki has the worst wiki markup of any wiki I've ever used. Avoid.

The company I'm working with at the moment is using Confluence, which is reasonable. I'd much rather be using MediaWiki or Trac though.

Twiki is good if a bit difficult to setup. Checkout wiki matrix: http://www.wikimatrix.org/

I've used moinmoin in the past and it worked very well.

http://moinmo.in/

EDIT: just wanted to add I've also used Trac http://trac.edgewall.org/

Have you checked out PBWiki? I've heard good things, but haven't done anything with it personally.

http://pbwiki.com/business.wiki

I just set it up, it looks quite good.

One to check out that has been used internally here is DekiWiki ("enterprise-friendly"). We've also began to use it on external collaborative projects. For dev you can't beat Trac right now but Redmine may just superceed Trac. Ones I tend to avoid are TWiki (hugely extensible, but therein lies its weakness) and horrors of all horrors - sharepoint. MediaWiki of "old" is great if you need something up quicky.

For an enterprise environment, Confluence is the best of the bunch.

1. It has commercial support (you did say: enterprise) 2. It's easy for non-techies to use 3. If you buy the optional "Crowd" product, you can do identity management using AD 4. Use the tomcat bundled version, but upgrade the VM allocated memory to a gig to prevent slowness. 5. Upgrade frequently

We use Plone CMS (http://www.plone.org) and it's fantastic. Loads of options beyond standard wiki, easy to set up.

Edit: Quote from their site - "An eWeek Labs Analyst's Choice award winner, this open-source product is one of the best solutions period - for company portals and intranets" - eWeek, April 2006 issue

Confluence

Why the frown? I've had success with Confluence at 4 or 5 companies. My biggest complaint is the handling of major revisions to a hierarchy of documents but that's something that's probably specific to me.

Confluence is a great fit for business and technical people in my experience.

1) J2EE. Which I suppose is a J2EE complaint, but the sins of the father...

2) Searching performs rather poorly in terms of the quality of results.

3) It's licensed.

4) It doesn't scale if you're doing anything more than a text repository.

5) Jira / Confluence integration is, imho, sub-par given that Atlassian makes them both.

Not an "end of the world, woe is me" story, but still ":("-worthy.

((NB: I haven't used any other wiki software, so it's possible that Confluence is far better than any other option...I hope not))

Yeah slowness is definitely ":("-worthy, but in my experience Confluence performs pretty well. It really depends how it's installed and how the database is setup also.

And the search is weak, I agree, but I haven't experienced any significant problems in scaling or Jira integration. It's also much more pleasant to deal with than SharePoint.

For technical-only teams, I highly recommend MoinMoin. It takes some hands on administration (maybe it's better now, I haven't used it for a couple of years) but it was worth it for the flexibility, plug-ins, and the fact that it stored pages in plain text files.

Nothing sucks more that Confluence - I feel your pain all too well :(

My company has utilized MediaWiki, Twiki and Confluence (current) over my year with the company. By far, Confluence is the worst in my opinion. Despite Twiki's setup pains, I still prefer it over MediaWiki (and other wiki's I've personally tried for that matter).

I've been using git-wiki recently, with great success:

http://github.com/jnewland/git-wiki/tree/master

yeah, but what do you do if, despite cajoling and management emphasis, none of the damn programmers want to use the damn things? they seem to feel the code is self-sufficient.

If you need extensibility and power, go with TWiki.

We use Twiki here at CoreStreet as well.

Sharepoint!

(No just kidding we use confluence among others)

Reply on news.ycombinator.com