NEW! Profitable Venture Tactics Forum and discussion group.
What is "documentation?"
To me, documentation is a CAUSE, an idea worth working for. Documentation is the beginning, the foundation, and the bedrock of worthy undertakings.
"Without a doubt my commitment to writing things down and having a system in place to remind me of my action items has been a major reason I've been able to achieve all that I have."
But recently someone asked me, "What do you mean by documentation?" Maybe people don't think about "documentation" often, but nearly everyone uses it. Have you read or used any of the following documentation lately?
Advertising, API documentation, banking records, brochures, bus schedules, business cards, cave art, computer files, Constitution and Bill of Rights, contracts, Declaration of Independence, diaries, divorce papers, email, graffiti, legal papers, licenses, manufacturing instructions, meeting agendas, mystery novels, newspapers, notes on the back of cocktail napkins, operations manuals, paper money, paper trails, pictographs, promissory notes, receipts, recipe books, Sanskrit writings, scripts for movies and plays, tax codes, technical manuals, threatening letters, etc.
Today, in addition to printed documents, a lot of documentation takes the form of data on disks, CDs, etc. But, in any format, documentation must be organized and encoded in a language that someone (or a machine) can understand.
IS COMPUTER DOCUMENTATION SIMILAR TO COMPANY DOCUMENTATION?
A computer system is an organization of functional components that operate to produce predictable result(s).
Similarly, a company is an organization of functional components that operate to produce predictable result(s).
Yet, they seem different. Is their documentation similar? In the following few paragraphs, I will compare a certain type of technical computer documentation with business documentation.
Have you ever heard the term "API?" In computer jargon, "API" means Application Programming Interface. (I don't know when the term "API" became popular, but application manuals for programmers have been around for decades.)
API documentation tells programmers how to use (interface with) pre-programmed Application Programs. The API document tells the programmer the precise language and message format expected by an Application Program.
The Application Program itself can be any computer function such as an operating system, a database management system, a communications protocol, a formatting program, a math function, whatever.
To implement an API, the programmer must write a PRECISE function-call for the Application. If the call is not precise and accurate, the computer may deliver unexpected results, or an undecipherable error message, or maybe the "blue screen of death!"
Below is a piece of API documentation, showing code for how to set up request variables for an application called DISPATCH.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [...] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Of course, the above instructions are written for a computer. I will spare you the rest of the API documentation that explains what all that means.
Programmers may need to spend a lot of time trying to understand API documentation, especially if it's poorly written. API documentation must be readable by programmers. Still, it can be intimidating, especially for calls to display or print information. Operating systems like Windows may have thousands of APIs.
The point is this: Using APIs, programmers must write precise code to communicate with the operating system and other software.
NOTE:Many software developers are slow to write their Application Program Interface (API) documentation. That means the development team relies on "tribal knowledge" and rumors!
Analogous to the above...
In business jargon, "BPI" means Business Process Interface. Never heard of BPI? I just made it up.
BPI documentation tells employees exactly how to interface with (use) predetermined Business Processes. The BPI documentation tells employees what input a given Business Process expects.
A Business Process can be any company function such as buying office supplies, booking a sale, developing a brochure, manufacturing a widget, whatever.
To use a Business Process Interface (BPI), the employee must provide information to the Business Process. If the information is not precise and accurate, the employee may get unexpected results, or an unintelligible memo, or maybe a "pink slip of termination!"
Here are a few steps I wrote for a Business Process called "Quick-Turn:"
The main steps for having the Quick-Turn item(s) shipped are as follows, listed in sequence of activities:
Requester: Prepare the Quick-Turn Shipping Request Form and obtain approvals as follows:
Of course, the above work instructions are written for human employees.
Employees may need to spend a lot of time trying to understand BPI documentation, especially if it's poorly written.
But, many companies have NOT written their Business Process Interface (BPI) documentation. That means the company relies on "tribal knowledge" and rumors!
The general process of writing either is the same, while the contents are quite different. Both take the ability to thoroughly research, organize, write and checkout the interface processes.
Help Profitable Venture Tactics help your colleagues.
This eZine relies on subscriber's participation. So, it stands to reason, the more subscribers, the more participation. You can expand the circulation by telling your colleagues about Profitable Venture Tactics.
Your business and management colleagues will thank you for being so thoughtful.
___ What did you learn today that you found most beneficial?
___ How will you apply what you have learned at work?
Mike Hayden, Principal/Consultant
Senior Management Services
Fax: (952) 674-1767
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
(c) 2006 Mike Hayden, All rights reserved.