Open Source

Selling open source with documentation

Recently I read a report on how one IT manager was dealing with the corporate office telling him he had to switch from LAMP to .NET. One of the main reasons corporate gave him was the lack of support for their system. They (corporate) told him if he were to leave there would be no one around who knew their systems.

That got me to thinking. This scenario is very common, and the one commonality that I find is, when the IT department is being asked to switch to proprietary systems, they have no documentation to help their case along. Why do I mention documentation? Well, with proper documentation, there would be no case for switching from open source to proprietary.

Here's a hypothetical situation:

Your department runs nearly every Web need of your company in a LAMP environment. Corporate takes notice of this and, even though the system is running at 100 percent uptime, they inform you they want you to switch to .NET. Why? Because of the copious documentation and support it comes with. At that point you whip out a Harry-Potter-thick binder filled with the complete documentation of every system in the company. This binder includes the network schematics, how-tos on upgrading, all security system documentation...everything.

At that point corporate has no ammo for their argument. On top of the IT "bible" you inform them that every system not created in house has full documentation on its Web site (which you will have printed out and included in the "bible") and that all related support forums have been bookmarked.

Unfortunately this scenario isn't the norm. In most instances when IT departments are using open source solutions, they fail to document. From my perspective, this is a huge mistake. I know of IT admins who do this on purpose for "job security." They know that as long as they are around the systems are safe. Although this might work for some people, for the rest, it's a strategy filled with holes.

So I propose that you open source your systems. What do I mean? Simple:

Create your systems (by "systems" I mean your in-house softwares, your network setups, etc.).

Document your systems.

Open source your system documentation (minus, of course, any security information that could lead to hackers gaining access).

How could you benefit from this? Well, once your systems were open sourced, you could possibly have the eyes of thousands of other IT admins looking at your setup and giving you advice on how to improve it. And once many systems have become open sourced you would have a bevy of documentation offering up solutions for nearly every problem. It would be a network of community-improved solutions complete with community-accepted documentation. Support would be built into the system. You have a problem — you simply contact the "network" of open sourced IT admins.

I realize this goes against the grain; it's not how we currently think. But it's a smart solution. It's a Vulcan-esque solution where the needs of the many would far outweigh the needs of the one.

Unfortunately this solution has to start somewhere. Who would be willing to be the first to open up their solutions? You? Do you document your solutions? Do you document your solutions well enough to keep corporate from making you change? Do you document your solutions well enough to show to other IT admins? Are you willing to? If it could save your job?

Think about it.

Open source your systems.

About Jack Wallen

Jack Wallen is an award-winning writer for TechRepublic and He’s an avid promoter of open source and the voice of The Android Expert. For more news about Jack Wallen, visit his website

Editor's Picks