3 ms·

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

• cscott 18y ago
  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.
  • figured 18y ago
    We use MediaWiki, it works for us just fine
    • dmharrison 18y ago
      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.
• thecrumb 18y ago
  Twiki is good if a bit difficult to setup. Checkout wiki matrix: http://www.wikimatrix.org/ http://www.wikimatrix.org/
• simonw 18y ago
  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.
• dazzawazza 18y ago
  I've used moinmoin in the past and it worked very well. http://moinmo.in/ http://moinmo.in/ EDIT: just wanted to add I've also used Trac http://trac.edgewall.org/ http://trac.edgewall.org/
• aleclair 18y ago
  We use Twiki here at CoreStreet as well.
• misterbwong 18y ago
  Have you checked out PBWiki? I've heard good things, but haven't done anything with it personally. http://pbwiki.com/business.wiki http://pbwiki.com/business.wiki
  • sam 18y ago
    I just set it up, it looks quite good.
• engtech 18y ago
  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.
• boredguy8 18y ago
  Confluence :(
  • fendale 18y ago
    Nothing sucks more that Confluence - I feel your pain all too well :(
  • delano 18y ago
    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.
    • boredguy8 18y ago
      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))
      • delano 18y ago
        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.
• chrismjohnson 18y ago
  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).
• ComputerGuru 18y ago
  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?
  • fendale 18y ago
    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.
• jnewland 18y ago
  I've been using git-wiki recently, with great success: http://github.com/jnewland/git-wiki/tree/master http://github.com/jnewland/git-wiki/tree/master
• somabc 18y ago
  Sharepoint! (No just kidding we use confluence among others)
• dizz 18y ago
  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.
• hubble 18y ago
  If you need extensibility and power, go with TWiki.
• bporterfield 18y ago
  We use Plone CMS (http://www.plone.org 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
• ra 18y ago
  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
• rcoder 18y ago
  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.
• deleted 18y ago
  [deleted]
• ekzept 18y ago
  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.