American University of Beirut Doc ID: AUB-IT-000001 Page 1 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage www.aub.edu.lb/it July 2013 Contact Person Joseph Hage Interim, Chief IT Quality & Compliance Officer American University of Beirut joe.hage@aub.edu.lb | Tel: +961-1-350-000 ext. 2568 | Mobile: +961-70-266-623 Beirut PO Box 11-0236, Riad El Solh 1107 2020, Beirut, Lebanon | Tel: 961-1-350-000 | Email: IT.compliance@aub.edu.lb New York 3 Dag Hammarskjold Plaza, 8th Floor | New York, NY 10017–2303, USA | Tel: 1-212-583-7600 | Fax: 1-212-583-7651 Note: When this document is released, it is to be followed and adhered to, and is subject to document AUB-IT-000001 “IT Document Control Policy”. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 2 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage TABLE OF CONTENTS 1. PURPOSE 3 2. DOCUMENTATION TYPES 3 2.1. Policies – Why? 3 2.2. Processes – What? 3 2.3. Procedures – How? 3 2.4. Templates 3 2.5. Documentation Categories 4 3. DEFINITIONS 4 4. POLICY 6 4.1. General Documentation Guidelines 6 4.2. IT Document Control 7 4.3. Revision Control 8 4.3.1. Revision Number Controlled Documentation 8 4.3.2. Date Controlled Documentation 9 4.4. Effectivity Date 9 4.5. Authoring History Log 10 4.6. Pre-Submission Checklist 10 4.7. Document Approvals 11 4.8. Transfer Authority and Escalation 11 4.9. Control and Approval by Document Type 12 5. COMPLIANCE WITH THIS POLICY 13 6. VIOLATION OF THIS POLICY 13 7. AUTHORING HISTORY 15 Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 3 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage 1. Purpose The purpose of this document is to serve as the official information technology (IT) document control policy within the American University of Beirut (AUB). It is to be maintained under change control by the Office of Information Technology (OOIT). The purpose of this policy is to: Establish a uniform and consistent method for preparing and handling IT documentation Specify who controls IT documentation Identify the location of IT documentation storage This Document Control Policy (DCP) governs the control, distribution, and removal of IT documentation, both hard copy and electronic. The DCP applies to all IT documentation within the Document Management System (DMS). All staff and faculty of AUB must adhere to the provisions set forth in this policy. 2. Documentation Types The University shall have four major types of IT documentation including Policies, Processes, Procedures, and Templates. 2.1. Policies – Why? Policies are guiding principles or course of action adopted towards an objective or objectives. Policy documents also describe why AUB is engaged in the activity. 2.2. Processes – What? Processes are collections of related procedures that start at a specific point and end at another as work tasks, activities, and functions are performed. Process documents describe what AUB does to achieve a certain result. 2.3. Procedures – How? Procedures consist of a collection of tasks that are performed by one or more resources. Procedure documents describe how AUB employees are expected to perform their tasks according to a process and as dictated by one or more policies. 2.4. Templates Templates are used as a tool and a starting point for creating various types of documents. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 4 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage 2.5. Documentation Categories Documentation is classified under the following two categories: Internally Generated Documents are produced by AUB faculty and staff. Examples of such documents include Specifications, Plans, Organizational Charts, Job Definitions, and more. Externally Generated Documents are produced by companies or individuals other and outside of AUB. Examples of such documents include Supplier Documents, Governmental Documents, and more. The system may also include miscellaneous documents, which must be date controlled. Examples of such documents include Templates, Frequent Dated Reports, Individual Objectives, and more. Miscellaneous Information may be either Internally Generated Documents or Externally Generated Documents. 3. Definitions Term Definition Affected Stakeholder(s) Individuals within or outside the University who are affected by the policy. Appendices Contain laws, regulations, and checklists that may pertain to the document. Approver(s) The University stakeholder(s) who approve(s) a document. Author(s) The document author is either the document owner or the person(s) designated by the document owner to write the document. This may include a cross-functional team to develop the document. Contacts Names the University office(s) that can answer specific questions regarding the document or approve exceptions. Definitions Alphabetical listing of the terms used in the document, to define unfamiliar terms that have a specialized meaning in the document. Doc Owner Person who “owns’ the process, procedure, policy, manual, or form defined in the document. A document owner is the person responsible for defining and improving the information in the document. A document must have one and only one owner. Forms/Instructions Lists forms the reader must use to comply with the policy, explains the purpose of each form, and may provide a hyperlink to the Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 5 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Term Definition applicable form(s). Internal Process Customer Person who benefits from the implemented process Internal Process Supplier Person who supplies goods and/or services to the implemented process. Policies and Procedures Office (PPO) The Policies and Procedures Office (hereinafter referred to as “PPO”) is responsible for maintaining the University’s online policies, procedures, bylaws, and manuals, and for ensuring that they are available to the appropriate staff. The PPO provides assistance in the formatting and editing of faculty and/or departmental manuals to ensure consistency of format, language, and content. All policies shall conform to the published University templates. Policies and Procedures Review Committee (PPRC) Standing committee of the University tasked with overseeing the development and/or revision of all University wide policies, bylaws, procedures, and manuals (also referred to herein as “documents”). The PPRC is also responsible for identifying lacunae and obsolete passages in AUB’s bylaws, policies, procedures, and manuals, and directing the development and/or the review of the documents identified. Members of the PPRC are appointed by the President and are tasked with reviewing departmental manuals whenever those manuals include procedures that have broader application than the department concerned. The committee shall meet to consider agenda items that may be submitted to it by the President, the Provost, the Policies and Procedures Office, or any of the University’s senior management staff. The PPRC shall obtain legal and other advice, as it deems necessary. It shall ensure that the documents it reviews are clear and consistent with those already approved. It shall submit to the President all university-wide policies, procedures, bylaws, and manuals for his/her final approval. The PPRC reports to the president and shall keep minutes of its meetings. Process Owner Person who is ultimately accountable for defining, measuring, implementing, and continuously improving the process. The Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 6 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Term Definition process owner must be able to manage the process across functional or organizational boundaries. Process User Person who uses the process. Responsibilities of process users include understanding the process, gathering any measurement data, recommending process corrections and improvements, and managing process participants relationships. Purpose of Policy States the legitimate interests of all parties, describes the problem or conflict the policy addresses, and cites any legal or regulatory reasons for the policy. Responsible Office Under the direction of the responsible university official, the Responsible Office shall develop and administer particular policies and procedures and shall be accountable for the accuracy of their subject matter, their issuance, and their timely updates. Scope A document must have a scope as to imply how wide it applies. For example, a procedure might not have broad impact on the University community as it could be limited in its scope and application to a specific department. Those with University-wide scope must be reviewed by the PPRC and approved by the President. 4. Policy 4.1. General Documentation Guidelines The following are general documentation guidelines to follow: All internally generated documentation should be assigned document numbers by the controlling organization. The document number must be created without any logic to it. The electronic copy of each document must be accessed by a file name, which includes the document number. Any member of staff or faculty may suggest amendments or corrections following consultation with the Document Owner. The Document Owner will be responsible for making the amendments or corrections to the document, which must be performed as soon as Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 7 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage possible. The Document Owner may delegate such responsibility to one or more Document Author(s). In case the documents had been printed, all copies in circulation must then be reprinted and inserted in place of the outdated and obsolete documents. The obsolete documents must be destroyed by shredding immediately. The Revisions and/or Authoring History page in the document must be completed to summarize what work has been done by the document editor. Revisions to any document must be approved by its owner whose name appears on the cover page as well as at least one other person. IT Documents affecting people outside of the IT organization must also be approved by the Policies and Procedures Review Committee (PPRC) and the President. Sole self-approval of documents is not accepted. 4.2. IT Document Control The following are IT document control guidelines to follow: All documentation is stored online in a Document Management System (DMS). Documents are assigned a Document ID formatted as AUB-NNMMMMMM, whereby NN represents the controlling organization and MMMMMM represents a serial number for the document. Documentation is controlled by the DMS Administrator and a DMS Document Control Manager. No hyperlinks to documents outside DMS are permitted, except to those within the AUB and AUBMC websites. References may be made to any documents outside DMS as long as the references are clear as to how the documents can be located. Upon the last approval, the documentation status becomes “Approved” in the DMS. Document control includes those documents required under the University’s adopted processes, procedures, policies, plans that direct or affect the course or content of the University’s activities and programs. Major changes must result in the immediate review and reissue of the procedure with a new Revision Number. A major change is defined as one that materially changes the operation of the procedure. Such Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 8 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage reviews and approvals occur via a document change in the DMS. Document amendment does not replace the document review process. The official controlled electronic version of all documents is the electronic file accessible in the DMS. Any document printed from the DMS is considered an uncontrolled document. Any person or organization, using uncontrolled documents, is responsible for ensuring that documentation used is current and that obsolete documentation is removed, deleted, shredded or otherwise assured against unintended use. All authoring and published documentations are located in the DMS system. Obsolete documents that are retained in the DMS shall be ignored as of the obsolescence date of the old document revision, which usually coincides with the effectivity date of the new revision. Published documents are accessible for all University staff and are subject to internal and external audits. 4.3. Revision Control All documents must be revision controlled either by a revision number or a date. 4.3.1. Revision Number Controlled Documentation When a document is distributed for review, it is considered as Drafted. It is necessary to log the date in the document’s Authoring History log each time changes are incorporated and the document is subsequently reviewed. Once the document is approved and considered final, its Revision number is incremented. Document Revisions must be in N.M format where N is a positive integer greater than 0 and M is a positive integer greater or equal to 0 (e.g., 2.5). The first revision of a new document must be 1.0. N must be incremented each time a significant modification is made to the document. A significant modification is defined to be a change where the overall document statement has been altered, either through modification, removal, or enhancement. M must be incremented each time any change is made to the document. If N is incremented, M must be reset to 0. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 9 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Document revisions shall be tracked in Microsoft Word (if Word is being used as the authoring tool) using Word’s Track Changes capability using the following process: Open the document to be modified Accept all changes from the previous revision by: o Select “Review | Track Changes | Accept or Reject Changes” o Select “Accept All” and answer “Yes” to accept all changes, assuming of course that you agree with the changes Make sure changes to the current revision are tracked by: o Select “Review I Track Changes I Highlight Changes” o Check “Track Changes While Editing” Make changes to the document as appropriate. To highlight areas where there are questions or comments intended for the audience, use the highlighting tool. This is available via the Highlight button. 4.3.2. Date Controlled Documentation Template files and external documentation shall be controlled and released based on a date. The date format shall be YYYYMMDD (e.g., 20130802 for August 2nd 2013 or 20140630 for June 30th 2014). The date of publication should be clearly indicated on the documentation. Most externally generated and miscellaneous documents should use this method of revision control. 4.4. Effectivity Date The following are effectivity date guidelines to follow: Date on which a particular revision of a document goes into effect. Effectivity date must occur after a document is released and after allowing enough time for training or re-training to take place for the users affected by the changes in the new revision. The last approver of the change order must ensure that the affected document has the appropriate effectivity date. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 10 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage 4.5. Authoring History Log The following are authoring history log guidelines to follow: A table included on the Revision page of each document containing a description of modifications to approved documents. The description will provide a detailed description of substantive changes. Grammatical changes need only be noted but not detailed. A document can be reissued and checked in under the same revision level if the changes are administrative in nature and do not involve process form, fit, or function changes. Ten or fewer minor amendments may be made before the procedure is revised. A minor amendment is defined as one that does not materially affect the operation of the procedure (e.g., a typographical error). These changes are checked into the attachments tab as versions of the specific file. If multiple authors are working on the same revision of the document, then they should not be repeating the same revision number on multiple rows. Instead, they should type their name, date and comments by pressing SHIFT-ENTER to keep all entries related to the same revision in the same cell of the Authoring History table. The guidelines set forth in the Revision Control section must be followed. 4.6. Pre-Submission Checklist The following is a pre-submission checklist to follow: Identify referenced documents such as procedures, policies, templates, or other reference documentation. Do not refer to other documents by revision number unless the use of a specific revision of that document is specifically required. The default is to refer the reader to the latest released revision. If the reader finds that there is a pending revision against the document, then the user is responsible to verify with the Document Owner about when the next revision will be available and put into effect. Identify those forms, reports, and other records that are the result of key steps in the document. Prepare and include a flowchart of all processes or procedures including inputs and outputs, if desired. Have the employees who perform any part of the document or who are affected by it review it. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 11 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Publish the document and set its Status to Published. Notify appropriate personnel of the approval and publication of documents. Search the DMS documents list and compare the document against existing documents. If there are similar documents, a determination must be made concerning whether both documents should be combined. This will streamline the DMS and reduce work. Review to ensure that the document meets the intent of the guidelines as specified in this document. Avoid the use of ambiguous or unclear terminology such as “if appropriate”, “significant”, or “minor” in describing activity or decision steps in the procedure. If such terms are used, they should be defined. Update the Authoring History log for revisions of approved documents. Update the Revision number in the page header, if applicable. Ensure that the documents referenced and used or created as part of this document are approved, controlled, and secured against unauthorized entry or destruction. 4.7. Document Approvals The following are document approvals guidelines to follow: Electronic signatures indicate review, understanding, and approval of a document. No e-mail approvals outside of DMS are acceptable as only electronic approvals through the DMS are. Except, if the e-mail message is saved from Outlook as an MSG file and then attached to the DMS document as an attachment. Paper-based signatures are accepted on a temporary basis after which the signature document shall be scanned and attached to an electronic approval in the DMS. The owner of document shall not be sole approver of its revision. 4.8. Transfer Authority and Escalation When a member of the team is out of the office and unable to check the DMS regularly, that person is required to transfer his or her authority to another user. The employee’s manager shall determine to whom the authority is transferred. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 12 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage The DMS also implements the escalation feature that escalates inaction to another DMS user, typically the Manager of the person. 4.9. Control and Approval by Document Type There are several types of documents in the DMS listed in the Doc Type drop down. They are: Form: Document that has blank spaces for the insertion of specified information. A form shall be approved by the manager of the person who developed the form. Job Definition: Document containing job descriptions and definitions for a particular department. A job definition document must be approved by the Manager in charge of that department. Initial Job Definitions must be assigned the HR Workflow and shall be forwarded at the end to the HR department. Manual: Reference or instruction document. A guide or manual shall be approved by the manager of the person who developed the guide/manual. Organization Chart: Document outlining the organizational structure of a particular department or organization. An organization chart must be approved by the Department Manager and a member of the executive staff. Plan: Outline of actions to be taken over a period of time to execute on a mission. A plan must be approved by the Manager of the person who created it. Policy: Guiding principle accomplishment. Procedure: Established way of performing an activity. A procedure document shall be approved by the manager of the people who perform the procedure. Process: Set of interrelated work activities that are characterized by a set of specific inputs and value-added tasks that produce a set of specific outputs. A process can be contained within a functional organization, or it can span several functional organizations. A process is repeatable and measurable; corrective action is used to correct process problems and improve process performance. A process document shall be approved by the Manager of persons who are Process Users or Internal Process Suppliers. or plan for an activity and its Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 13 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Project: Set of work breakdown structure items and the resources assigned to execute them. A project shall be approved by all managers who have resources assigned to the project as well as the Program Manager managing the project. Project documents should refer exclusively to the project’s Code Name. Report: Document presenting a data set to the reader. A report shall be approved by the person who prepared it. Specification: specifications. Service Level Agreement (SLA): Document outlining an agreement about services to be provided to end users. Statement Of Work (SOW): Document outlining scope and deliverables to be provided to end users. Template: Document to be used as a framework for the creation of other documents. Templates shall be approved by a DMS Administrator. Document featuring technical or business 5. Compliance with this Policy The Chief IT Quality and Compliance Officer is responsible for ensuring compliance with and enforcing this policy. All IT staff must adhere to this policy when authoring information technology documents. 6. Violation of this Policy All users are advised that, in addition to being a violation of University rules, certain computer misconduct is prohibited under Lebanese laws and is therefore, subject to criminal penalties. Such misconduct includes gaining unauthorized access to controlled documents by breaking through a security measure, falsely obtaining electronic services or data, destroying of electronically processed, stored, or intransit data, and using the Internet or an information technology device to threaten or blackmail another to act or not. Any violation of this policy or applicable Lebanese laws will be subject to investigation and/or disciplinary action, up to and including termination of employment, termination of enrollment, and referral to the appropriate law enforcement authorities in the appropriate cases. Questions concerning any aspect of this policy should be directed to the Chief IT Quality and Compliance Officer at the Office of Information Technology. The Office of Information Technology reserves the right to take appropriate action at any time to maintain and protect the confidentiality and integrity of the University’s documents. Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 14 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential. American University of Beirut Doc ID: AUB-IT-000001 Page 15 of 15 Title: IT Document Control Policy Revision: 1.1 Owner: Joseph Hage 7. Authoring History Revision 1.0 1.1 Date (DD-MM-YYYY) 07-06-2012 20-10-2012 Author Joe Hage Joe Hage 10-12-2012 07-03-2013 Joe Hage Joe Hage Reason for Changes Initial version Edits based on clarifications requested by Andre Nahas, PPRC Chairperson Final changes based on requests for change from PPRC Implemented new template with minor edits Copyright © 1866-2013, American University of Beirut. All Rights Reserved. This information is for internal use only, proprietary and confidential.