March 01, 2005
Documentation for Its Own Sake
IT projects in the pharmaceutical industry require documentation. Although this may be the least favorable aspect of a project for a technical professional, it is a necessary part of the system delivered. Documented evidence of all aspects of the project is required by regulation to achieve a validated state. This should therefore be the primary objective of the documentation for any validated system. However, a secondary objective should be producing documentation that is less time consuming and adds greater value to the project.
Too often the objective for producing documentation becomes its own justification- documenting for the sake of the requirement to document. This will inevitably lead to poor quality documentation and more effort. How often have we seen a requirements document produced at the wrong stage in a process because poor planning failed to produce the right content for requirements at the right stage in the project? Poor documentation will always result in additional work as well. A design specification can not hope to document design of a well built, validatable system unless it can draw corollary to the functional and user requirements. Likewise, a validation protocol can not be conceived at the validation phase. Poor validation protocols can attempt to verify that a system functions as it was designed. But without the foundation of acceptance criteria in the user requirements and functional specifications, it can never prove that the system performs as intended. When all the pieces of documentation don’t fit together in their correct chronological order and with appropriate content, then the entire team inevitably becomes encompassed in the tasks of trying to make the pieces fit retrospectively.
Project documentation must start at the beginning and follow a sound plan. Each document must be constructed with appropriate scope and content consistent with that plan, always looking forward to the needs of the next document or next project phase. Documentation can also not be left to the validation team. The entire team must contribute to, review and be thoroughly familiar with each document. Team members from all involved areas, users, customers, developers, testers, quality, IT, project managers, and senior management must recognize documentation as part of their responsibility and actively participate in each.
Posted by John Buletza at March 1, 2005 04:27 PM
Trackback Pings
TrackBack URL for this entry:
http://www.jandrconsult.com/cgi-bin/mt/mt-tb.cgi/20
Listed below are links to weblogs that reference Documentation for Its Own Sake:
» home theater systems. home theater information. from home theater systems. home theater information.
[Read More]
Tracked on April 26, 2006 02:45 AM