Project Documentation Naming Conventions and Repository Guideline

Download 282.5 Kb.
Size282.5 Kb.

Project Documentation Naming Conventions and Repository Guideline

Project Documentation Naming Conventions and Repository Guideline


The purpose of the Project Documentation Naming Conventions and Repository Guideline is to establish project documentation naming standards and structure for project documentation repositories. This guideline is intended to help the project manager organize the project notebook by providing a simple set of rules for creating and storing project documentation, and illustrates the application of these rules to a sample project.


Two important components of any Project Management Repository (PMR) are a standard project repository structure and standard project naming conventions. Other important components of a PMR include the physical repository (file store or database), as well as, the processes related to creating, managing, and archiving the project management documentation.

A project documentation repository supported by an established project repository structure (taxonomy) provides an area for creating, managing, and archiving project management data and documents for a specific project. It enables the project team to work together in an efficient manner, and supports re-use of data and documents in executing project management practices on future projects.

Project naming conventions include a standard format for the name and unique identification of each project, and standard identification for each project deliverable. The naming conventions also include version control attributes for both project management and software development (engineering) documentation.

Project naming conventions and a project repository structure provide a number of benefits that are important for improving project management practices. Specifically, they enhance:

  • Project team communication

  • Project management efficiency

  • Project documentation management

  • Configuration Management of project deliverables

  • Project orientation for new team members

Project Classes

Projects are classified as Class A, Class B, or Class C using the Project Classification Criteria template. The project classification criteria are:

  • Impact on Citizens, Operations, and Agencies

  • Visibility

  • Impact of Not Completing the Project

  • Maturity of Technology

  • Agency Project Management Capability

    A complete explanation of project classification can be found in the PM Guide, PM Handbook, SD Handbook, or Project Classification Criteria template.

Class A and Class B Projects – Project Repository Structure

    For Class A and Class B projects, the project manager and team use the Software Development Project Handbook or the PM Handbook as a reference for executing each project. For the Class A and Class B projects, the project team creates and manages a significant number of project deliverables to maintain adequate control of the project. For these projects, the project manager should consider establishing a project repository that is aligned with the methodologies and required deliverables. Table 2 provides an overview of a recommended project repository structure for Class A and Class B projects. The project repository structure includes a reference Work Breakdown Structure (WBS) ID that is matched to schedule and cost information, folder name, and associated project documents/deliverables.

    Table 2. Project Repository Structure – Class A and B Projects


Folder and Sub-Folder Name



Project [Name]

  • Project Name



  • Project Initiation Document (PID)

  • Concept Analysis Document (CAD)



  • Software Requirements Specification (SRS)

  • Requirements Traceability Matrix (RTM)

  • Use Cases

  • Support Expectations

  • Technical Evaluation

  • Requirements Walkthrough

  • Systems Diagram



  • High Level Design Document

  • Detailed Design Documents

  • Design Walkthroughs



  • Code Walkthrough



  • Test Plan

  • Defects Tracking Log

  • Acceptance Test

  • Final Test Report


Documentation and Training



  • System/Application Support

  • Deployment Strategy and Plan

  • Release Readiness Review

  • Installation Test

  • Initial Release Final Report

  • Deliverables Acceptance Form

  • Support Interaction Final Report


Project Management

  • Project Initiation Document

  • Management Approaches

  • Communication Matrix

  • Project Closeout Report

  • Client Satisfaction Survey


Change Control

  • Request for Change

  • Change Log



  • Contractual Agreements

  • Legal Documents


Costs and Justification

  • Business Case

  • Project Funding Form

  • Project Budget

  • Project Budget Report


Meetings & Memos (client, team, steering committee, etc.)

  • Agenda and Notes


Project Logs

  • Risk and Response Log

  • Lessons Learned

  • Issues Log


Project Team

  • Team Member Evaluation

  • Project Organizational Chart

  • Project Survey



  • Project Schedule

  • WBS

  • Project Timeline


SCM (Software Configuration Management)

  • SCM Plan


Status Reports

  • Project Status Report

  • Team Member Status Report

  • Executive Status Report

  • Quarterly Operations Review

The project manager should use the information contained in the above table to create a project folder for each project. The project manager should create a project folder on a shared drive and/or as a shared folder to establish a project repository for the project team. Other options may include web site or version control type software. The following is an example of a shared folder that may be created for a project.

Class A and B Project Documentation – Taxonomy
The project manager should consider creating sub-folders within the main project folder that correspond to the WBS structure. Project documents associated with each WBS item would be managed and stored within the corresponding sub-folder. For example, all test documents regardless of when they are initiated in the project life cycle, would be managed in the folder designated as 1.5 Testing.

To further organize and manage software development and project management deliverables for each project, the project manager should consider sub-dividing the folder designated as 1.8 PM – SD (Project Management and Software Development practices) into a number of sub-folders. The following chart provides a suggested structure for the sub-folders. The project manager and project team may then use the sub-folders for organizing and managing the deliverables identified by WBS 1.81 – 1.89 listed in Table 1.

Project Management - Software Development Practices Taxonomy

Class C Projects – Project Repository Structure

For Class C Projects the project manager and project team typically manage project activities less formally, requiring a smaller number of project deliverables and less structure in the project repository. It is important to note however, that although Class C projects are smaller or less critical, the project manager should still manage the project using the principles and practices outlined in the PM Guide and handbooks. For these smaller projects, a checklist has been provided which summarizes the important activities and deliverables that are required of the project manager and team.

    Table 3 provides an overview of a recommended project repository structure for Class C projects and includes a folder name and the types of associated project documents/deliverables.

    Table 3. Project Repository Structure – Class C Projects

Folder or Sub-Folder Name



Project [Name]

Main folder containing project information. Project’s name appears on folder.

  • Project Name

Project Plans

Sub-folder containing information used in project planning.

  • Business Case

  • Budget

  • Organization Chart


Sub-folder that contains requirements, design, and development information.

  • Requirements Documents

  • Design Documents


Sub-folder that contains testing, documentation and training, deployment, and support information.

  • Test Plans

  • Deployment Plans

  • Documentation and Training Plans

  • Release Readiness Review

Project Management-Software Development (PMSD)

Sub-folder that contains information required to manage and control the project.

  • Schedule

  • Risk Documents

  • Issues Tracking

  • Cost Tracking

  • Time Tracking

  • Change Control

  • Project Closeout

The project manager should use the information contained in the above table to create a project folder for each Class C project. The project manager should create a project folder on a shared drive and/or as a shared folder to establish a project repository for the project team. The following is an example of a shared folder that may be created for Class C projects.

Class C Project Repository Taxonomy
Project Naming Conventions

The organization has adopted a set of standard naming conventions for projects and associated project deliverables. The project manager should consider adopting these standards for each project, which will help in organizing project information; facilitate the sharing of information between projects and aid in searching and retrieving historical information.

The naming convention for project deliverables includes the document designation, abbreviated project name, preparation date of the document for version control, and the standard (3- letter text) extension associated with the software program used to create the document. The following illustrates the standard naming convention for a Software Requirements Specification, created as a Microsoft Word Document, for the SCORE project on October 21, 2001.

The original template for the (above) illustrated project document was Temp_SRS or Blank_SRS (if a blank template was used). To create the project document designation, the project manager or team member should modify the original template as follows:

  1. Delete the “Temp” designation and the first underscore ( _ ) associated with each template.

  2. Insert an underscore ( _ ) and the project abbreviation after the document identification.

  3. Insert an underscore ( _ ) and the date (in mmddyyyy format) the document was created following the project abbreviation.

For further elaboration, the appendix of this document provides a list of all the potential project documents. This table includes the initial template name designation, project naming convention, and an example illustrating how the naming convention should be applied to a project.


A standard project repository and project naming conventions help the project manager and project team to organize and share information efficiently. Additionally, standardization of a project repository structure and project naming conventions will help organizations establish an effective PMR, archive project information, and use this information as input or a starting point for future project documents.

References and Related Guideline

Project Management Body of Knowledge (PMBOK 2000 Edition)

  • Project Integration Management

Appendix - Naming Conventions and Examples

Project Documentation/ Deliverable

Template Name (These are the document names that will be found on the web site if the user attempts to download a template with instructions, blank template, or example template.)

Project Documentation Example (This is the naming scheme that a user should use when naming a template that will be stored in their project repository)

Acceptance Test

  • Temp_AcceptanceTesting.doc

  • Blank_AcceptanceTesting.doc

  • Ex_AcceptanceTesting.doc


Business Case

  • Temp_BusinessCase.doc

  • Blank_ BusinessCase.doc

  • Ex_BusinessCase.doc


Change Log

  • Temp_ChangeLog.xls

  • Blank_ChangeLog.xls

  • Ex_ChangeLog.xls


Client Satisfaction Survey

  • Temp_ClientSatisfactionSurvey.doc

  • Blank_ ClientSatisfactionSurvey.doc

  • Ex_ ClientSatisfactionSurvey.doc


Communications Matrix

  • Temp_CommunicationsMatrix.doc

  • Blank_ CommunicationsMatrix.doc

  • Ex_CommunicationsMatrix.doc


Concept Analysis Document (CAD)

  • Temp_ConceptAnalysisDocument.doc

  • Blank_ConceptAnalysisDocument.doc

  • Ex_ConceptAnalysisDocument.doc


Defect Tracking Log

  • Temp_DefectTrackingLog.xls

  • Blank_DefectTrackingLog.xls

  • Ex_DefectTrackingLog.xls


Deliverables Acceptance

  • Temp_DeliverablesAcceptance.doc

  • Blank_DeliverablesAcceptance.doc

  • Ex_DeliverablesAccpetance.doc


Deployment Strategy and Plan

  • Temp_DeploymentStrategyAndPlan.doc

  • Blank_DeploymentStrategyAndPlan.doc

  • Ex_DeploymentStrategyAndPlan.doc


Documentation Plan

  • Temp_DocumentationPlan.doc

  • Blank_DocumentationPlan.doc

  • Ex_DocumenationPlan.doc


Executive Status Report

  • Temp_ExecutiveStatusReport.doc

  • Blank_ExecutiveStatusReport.doc

  • Ex_ExecutiveStatusReport.doc


High Level Design

  • Temp_HighLevelDesign.doc

  • Blank_HighLevelDesign.doc

  • Ex_HighLevelDesign.doc


Implementation Strategy and Plan

  • Temp_ImplementationStrategyAndPlan.doc

  • Blank_ImplementationStrategyAndPlan.doc

  • Ex_ImplementationStrategyAndPlan.doc


Initial Release - Final Report

  • Temp_InitialReleaseFinalReport.doc

  • Blank_InitialReleaseFinalReport.doc

  • Ex_InitialReleaseFinalReport.doc


Installation Test

  • Temp_InstallationTest.doc

  • Blank_InstallationTest.doc

  • Ex_InstallationTest.doc


Issues Log

  • Temp_IssuesLog.xls

  • Blank_ IssuesLog.xls

  • Ex_IssuesLog.xls


Lessons Learned

  • Temp_LessonsLearned.xls

  • Blank_LessonsLearned.xls

  • Ex_LessonsLearned.xls


Meeting Agenda

  • Temp_MeetingAgenda.doc

  • Blank_MeetingAgenda.doc

  • Ex_MeetingAgenda.doc


Meeting Notes

  • Temp_MeetingNotes.doc

  • Blank_MeetingNotes.doc

  • Ex_MeetingNotes.doc


Project Budget

  • Temp_ProjectBudget.xls

  • Blank_ProjectBudget.xls

  • Ex_ProjectBudget.xls


Project Closeout Report

  • Temp_ProjectCloseoutReport.ppt

  • Blank_ProjectCloseoutReport.ppt

  • Ex_ProjectCloseoutReport.ppt


Project Initiation Document (PID)

  • Temp_ProjectInitiationDocument.doc

  • Blank_ProjectInitiationDocument.doc

  • Ex_ProjectInitiationDocument.doc


Project Organizational Chart

  • Temp_OrganizationalChart.ppt

  • Blank_OrganizationalChart.ppt

  • Ex_OrganizationalChart.ppt


Project Phase Kickoff Presentation

  • Temp_ProjectPhaseKickoffPresentation.ppt

  • Blank_ProjectPhaseKickoffPresentation.ppt

  • Ex_ProjectPhaseKickoffPresentation.ppt


Project Schedule – Generic (Excel)

  • Temp_GenericSchedule.xls

  • Blank_GenericSchedule.xls

  • Ex_GenericSchedule.xls


Project Schedule – Generic (MS Project)

  • Temp_GenericSchedule.mpp

  • Blank_GenericSchedule.mpp

  • Ex_GenericSchedule.mpp


Project Schedule – Spiral (Excel)

  • Temp_SpiralSchedule.xls

  • Blank_SpiralSchedule.xls

  • Ex_SpiralSchedule.xls


Project Schedule – Waterfall (Excel)

  • Temp_WaterfallSchedule.xls

  • Blank_WaterfallSchedule.xls

  • Ex_WaterfallSchedule.xls


Project Schedule – Waterfall (MS Project)

  • Temp_WaterfallSchedule.mpp

  • Blank_WaterfallSchedule.mpp

  • Ex_WaterfallSchedule.mpp


Project Status Report

  • Temp_ProjectStatusReport.doc

  • Blank_ProjectStatusReport.doc

  • Ex_ProjectStatusReport.doc


Project Survey

  • Temp_ProjectSurvey.doc

  • Blank_ProjectSurvey.doc

  • Ex_ProjectSurvey.doc


Quarterly Operations Review

  • Temp_QuarterlyOperationsReview.ppt

  • Blank_QuarterlyOperationsReview.ppt

  • Ex_QuarterlyOperationsReview.ppt


Release Readiness Review

  • Temp_ReleaseReadinessReview. doc

  • Blank_ReleaseReadinessReview.doc

  • Ex_ReleaseReadinessReview.doc


Request for Change

  • Temp_RequestForChange.doc

  • Blank_RequestForChange.doc

  • Ex_RequestForChange.doc


Requirements Specification (Non-software Projects)

  • Temp_RequirementsSpecification.doc

  • Blank_RequirementsSpecification.doc

  • Ex_RequirementsSpecification.doc


Requirements Traceability Matrix

  • Temp_ReqTraceabilityMatrix.xls

  • Blank_ ReqTraceabilityMatrix.xls

  • Ex_ReqTraceabilityMatrix.xls


Requirements Walkthrough

  • Temp_RequirementsWalkthrough.xls

  • Blank_RequirementsWalkthrough.xls

  • Ex_RequirementsWalkthrough.xls


Risk Assessment Tool

  • Temp_RiskAssessmentTool.xls

  • Blank_RiskAssessmentTool.xls

  • Ex_RiskAssessmentTool.xls


Risk and Response Log

  • Temp_RiskAndResponseLog.xls

  • Blank_RiskAndResponseLog.xls

  • Ex_RiskAndResponseLog.xls


Software Requirements Specification (Access Database)

  • Temp_SRS.mdb


Software Requirements Specification (Excel Document)

  • Temp_SRS.xls

  • Blank_SRS.xls

  • Ex_SRS.xls


Software Requirements Specification (Word Document)

  • Temp_SRS.doc

  • Blank_SRS.doc

  • Ex_SRS.doc


Standard Documentation Evaluation Form

  • Temp_StandardDocEvaluationForm.doc

  • Blank_StandardDocEvaluationForm.doc

  • Ex_StandardDocEvaluationForm.doc


Steering Committee Presentation

  • Temp_SteeringCommitteePresentation.ppt

  • Blank_SteeringCommitteePresentation.ppt

  • Ex_SteeringCommitteePresentation.ppt


Support Expectations

  • Temp_SupportExpectations.doc

  • Blank_SupportExpectations.doc

  • Ex_SupportExpectations.doc


Support Interaction Final Report

  • Temp_SupportInteractionFinalRpt.doc

  • Blank_SupportInteractionFinalRpt.doc

  • Ex_SupportInteractionFinalRpt.doc


System/Application Support

  • Temp_SystemApplicationSupport.doc

  • Blank_SystemApplicationSupport.doc

  • Ex_SystemApplicationSupport.doc


Systems Diagram

  • Temp_SystemDiagram.xls

  • Blank_SystemDiagram.xls

  • Ex_SystemDiagram.xls


Team Member Evaluation

  • Temp_TeamMemberEvaluation.doc

  • Blank_TeamMemberEvaluation.doc

  • Ex_TeamMemberEvaluation.doc


Team Member Status Report

  • Temp_TeamMemberStatusReport.doc

  • Blank_TeamMemberStatusReport.doc

  • Ex_TeamMemberStatusReport.doc


Technical Evaluation

  • Temp_TechnicalEvaluation.doc

  • Blank_TechnicalEvaluation.doc

  • Ex_TechnicalEvaluation.doc


Test Plan (Master)

  • Temp_TestPlanMaster.doc

  • Blank_TestPlanMaster.doc

  • Ex_TestPlanMaster.doc


Test Plan (Minor)

  • Temp_TestPlanMinor.doc

  • Blank_TestPlanMinor.doc

  • Ex_TestPlanMinor.doc



  • Temp_Timeline.ppt

  • Blank_Timeline.ppt

  • Ex_Timeline.ppt


Training Plan

Not Developed (Does Linda Knecht have this?)

  • Temp_TrainingPlan.doc

  • Blank_TrainingPlan.doc

  • Ex_TrainingPlan.doc


Use Case

  • Temp_UseCase.doc

  • Blank_UseCase.doc

  • Ex_UseCase.doc


Page of

Share with your friends:

The database is protected by copyright © 2019
send message

    Main page