There are times that I feel I am at my most creative when I work alone.
When I work alone, I am not bound by other's past failures. When I am cheerful, I don’t realize how monumental a task I have broached. When I cannot build on the work of those that came before me, I am not hindered by their missteps. And there are conventions in Telecommunications industry of which I am completely ignorant.
A few years ago, when we first started documenting the physical infrastructure of the University of Florida there were only a few student laborers and myself. I don’t think any of us truly appreciated the breadth of the task we were undertaking. In the beginning, we were only tasked with documenting OSP fiber cables. Now, piece by piece, the breadth of that project has grown to encompass every physical aspect of the UF building networks. We have grown as well. From a group of student laborers and me, we have grown to include over 20 full time staff members.
In the beginning, each individual staff member held complete responsibility for documenting their own work. Any one person that deployed a new circuit held responsibility for documenting every component of that circuit. With only four staff members, we clearly could not hand off our documentation to any other group. In addition, by deploying a new labeling standard we were in a position where no one else could understand the significance of the labels we were creating. No one person was expected to be an expert but each staff member was expected to be able to navigate a plethora of systems managed by other groups. By documenting the physical cabling infrastructure we interfaced with our networking core group, our facilities group, all local IT support personnel, and UF’s physical plant division.
As VoIP began to take hold on our campus, we experienced the now common struggle of integrating our telecom staff with our networking groups. I am sad to say that over time, the majority of our telecom staff has been let go. But, as the few that are left have been brought into the fold, there is an interesting idea taking hold.
A number of us that grew out of the telecom industry are asserting that we could increase productivity by removing data entry and documentation responsibility from the field technicians and move it into the hands of data entry specialists. The idea has some merit. Data entry specialists can be expected to know the ins and outs of our documentation systems and should have an easier time sorting out system problems. This would free up our network technicians to focus on solving network problems and focus on delivering new network services. If we had more staff to begin with, we may have gone this same route.
Our own core networking group has student staff dedicated to updating their logical diagrams and router documentation. But, we didn’t, and I’m glad.
I am certain that the separation between those that do the work, those that update the documentation, and those that use the documentation does irreparable harm.
For our core group, logical diagrams are often out of date. An engineer that does work may forget to hand off the documentation work. The doc team, for all of their good intentions, has no follow up capability because they don’t know what each member of the core group is doing. The most reliable documentation they maintain is based on dynamic querying of the devices that they manage.
For our telecom group, this means that a technician hands off notes from a work order to a customer service rep to enter into their billing system. The CSR enters what they are given but have no true understanding of activity in the field. Where there is confusion between the technician and service rep, the technician must be available to clear up the problem. In a situation where they must call back a technician to explain, the department then has to account for those hours since each technician’s hours must be billable.
So, a documentation specialist calls a technician/engineer for clarification.
The technician/engineer is not responsible for documentation so they delay in answering questions.
This rewards the service rep for “figuring” it out.
This corrupts the documentation.
The documentation then has no value for the field technician.
The field technician does not document their work.
And the cycle goes on, and on.
Our staff who spent time working in telecommunications lament the days where others performed data entry and documentation. In their minds, the older system worked. Their tasks were simpler, and they weren’t hounded for documentation mistakes. Where before they handed folders off to data entry specialists they are now expected to document their own work and account for any errors they create in the system. The transparent nature of this model makes it appear less credible than its telecommunication predecessor.
Our current system constantly checks itself for documentation errors. Those errors are assigned as work orders and corrected. Current error counts are public record and currently stand at .47% of our total record count of 50,000 records. But, the old system never reported errors because it had no method for discovering them. Therefore, it was perfect.
The paradigm shift from specialized data entry staff to distributed data entry can be difficult for staff. Any change can be difficult. There are those here that still bemoan the expense of labeling a cable. But, for our application, holding individual technicians responsible for their own documentation has paid dividends over and over again. Not only can individual technicians document their own work, they invest the documentation with value through their own use.
Unused documentation is not worth having.