One of the best examples of collaborative documentation efforts
at the time of writing is Wikipedia.
This tool is built on
MediaWiki,
which provides a general purpose
way of offering a wiki to those that want one.
By default the system is fairly open, on the assumption that
people using it will want to share and collaborate.
There are more tightly controlled wiki environments more
suited to the corporate world, where openness, sharing and
collaboration cannot simply be assumed. Examples include
Twiki and
Confluence.
All are good wiki offerings in their own way.
Then, there's the Micro$oft way.
Sharepoint is widely deployed in commercial development
environments, supposedly to facilitate document sharing.
Here is why using Sharepoint to do that
is a very bad thing, why your project
shouldn't do it and what to do if that mistake has already
been made.
Sharepoint
Reasons to avoid Sharepoint:
- It is only available for Micro$oft platforms.
- It's expensive. It is a separately purchasable product (part of Office).
- It's expensive. You need to run a portal server, which is also separately chargeable
- It's hard to set up and administer. That's why there are jobs
advertised for people with Sharepoint experience (see
Sharepoint/Alfresco comparison)
.
- I have observed that people tend to be locked out of
Sharepoint repositories far more often than is supposed to be the case.
Sharepoint does not seem to be very good at, er, sharing.
See the links below. It's not just me that is against Sharepoint.
Links
So, if you are not going to use Sharepoint, what do you use instead?
Wikis are only part of the solution, since most wikis are not
good at document management (they are better at the informal
evolving documentation).
Sharepoint is actually aimed more at official
document management. A project is going to have a mixture
of informal and formal documentation.
Doesn't that mean that Sharepoint should
be used as well as a wiki? No.
I will give a detailed list on why not at some point soon, hopefully.