Professional Documents
Culture Documents
Table of Contents
Introduction to this Guide ................................................................................. 3 Introduction to the SDLC Process .................................................................... 3 What we gain ...................................................................................................... 4 What we accomplish .......................................................................................... 4 The SDLC Phases............................................................................................... 5 Templates and IGs ............................................................................................. 5 How an IG helps you write a deliverable .......................................................... 6 Creating a SDLC deliverable set for your project............................................ 7 Finding and downloading a Template .............................................................. 8 Writing a deliverable from a Template.............................................................. 8 Word formatting tips and tricks ........................................................................ 9 Appendix A ....................................................................................................... 11 Appendix B ....................................................................................................... 21 Appendix C: mSDLC Deliverables by Phase Chart .......22
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 2 of 23
use Templates and Instructional Guides (IGs) read and use an IG create a SDLC deliverable set for your project find and download SDLC Templates write a deliverable using a Template utilize a few simple Microsoft Word (Word) formatting tips and tricks
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 3 of 23
What we gain
By instituting and using the SDLC Process, the organization should implement quality systems (according to specifications and with minimal issues) and should incur minimal project waste (cost/schedule overruns, rework). Many company computer systems must comply with external regulations and industry standards (for example, FDA regulations and 21 CFR Part 11 requirements, ISO 9000, SOX controls) and must include validation activities. Therefore, the SDLC Process should help us to act in accordance with these regulations and standards.
What we accomplish
In following the SDLC Process, the goal of following is that the project team, the business customers, and senior management can verify and ensure that
elements of a computer system project are managed activities and decisions are documented changes to the project and system are controlled system bugs and testing variances are resolved and recorded what was asked for is delivered
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 4 of 23
Explore Phase Define Phase Design and Build Phase Test Phase Deploy Phase
Each Phase contains a set of deliverables. See the appendices for a table and a chart that match deliverables to Phases.
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 5 of 23
Introduction
Activity Description
States when in the SDLC process this deliverable occurs Provides a high level summary of the deliverable Notes any special circumstances about the deliverable
SDLC Roles
Describes who, by functional role, typically writes, reviews, and approves this particular deliverable type Important: No cross-over of Roles is allowed, which means that a Project Manager cannot be the reviewer of a deliverable they authored.
Process Instructions
Describes how to write the deliverable Lists other SDLC deliverables that influence this deliverable
Useful Inputs
Tailoring Guidelines
Accounts for special needs related to both the project and deliverable Note: The Tailoring Guidelines section is the place to provide any specific instructions about
Excluding parts of the deliverable from this version Excluding the entire deliverable from the set
The choice to include or exclude sections is based on the characteristics of the project.
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 6 of 23
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 7 of 23
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 8 of 23
Body Text, Body Text 2, Body Text 3 List Bullet, List Bullet 2, List Bullet 3 Heading 1, Heading 2, Heading 3
To access Styles
On the Formatting Toolbar, click the Style drop-down list.
To edit Styles
Use the New Style/Modify Style dialog box.
Menu commands (File, Edit, View, and so forth) Style Area (Normal View only) Styles and Formatting pane
Using the preceding options allows you to control formatting, but using the icons on the toolbar allows Word to control the formatting.
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 9 of 23
Help menu Box entitled Type a question for help (Northeast corner of Word window) Microsoft Office Online Help Desk (x4357)
Your Notes:
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 10 of 23
Word document Enter text into fields Provides initial project information required to determine if project will proceed and estimates resource types, project costs, and schedules. Word document Enter text into fields Provides a quick and consistent method for performing a documented assessment of the regulatory significance of the named system Excel worksheet (protected) Enter data into designated fields Lists the required SDLC deliverables for a project
RAF
TPT
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 11 of 23
Word document Write sections Describes total cost and projected benefits to the company given the constraints and assumptions Excel worksheet Enter data into designated fields Provides analysis of the one-time and ongoing operational costs for the project and Analyzes both external out-of-pocket costs, as well as internal labor costs Word document Complete tables Assesses factors in determining the change implementation approach and the method for managing the change Word document Complete table Supports communication planning and other project management activities Excel worksheet Enter data Identifies people with communication needs; defines intent of communication; outline plan for communicating Word document Complete tables
TCO
Commitment Chart
Communications Plan
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 12 of 23
Define Phase
Highlights the specific infrastructure components needed for project development and system operation Word document; email message: Portal Messenger article; another announcement mechanism Write charter in appropriate medium Authorizes the project to exist; legitimize the role of the project manager Word document Write the sections needed Charts the course of the project Word document Example only available Microsoft Project template Enter data Sets expectations for project start / finish dates, for resource allocation, for dependencies between the different project activities PowerPoint document Modify existing Template Use for visual presentation of project progress Word document Write sections; complete table Provides a structured approach to identifying both project and system risks
Project Charter
Project Plan
Project Snapshot
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 13 of 23
Define Phase and to planning risk management activities RACI Roles and Responsibilities
Word document Complete the table Creates clarity and a common understanding of the decision-making and participative roles of the project stakeholders Word document Complete tables Specifies how scope changes will be managed and approved Word document Complete tables Describe all aspects of project scope to provide a basis for scope management Word document Enter the data; edit as needed Provides the basis for managing the relationship between the provider and the customer and maintain and improve service quality Word document Complete the tables Defines the expected service levels and performance criteria Word document Complete the table Documents the set of capabilities that
Scope Statement
SLA
SPA
URS
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 14 of 23
Word document Write the sections with care and detail Describes the tasks required to establish, to a high degree of assurance, that a system is performing its intended functions according to pre-defined specifications
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 15 of 23
Word document Complete the tables Determines and tracks configuration items that constitute a released system and the processes involved in managing them Word document or Excel worksheet Complete the table documents the attributes for one of three elements Configuration Items, Components, or System Configuration Word document Complete tables Identifies the steps needed to complete a correct and successful migration; plan can guide a report if a report is needed Word document Write sections Describes the approach to making a system operational Word template; (Excel worksheet or Visio diagrams may be appropriate) Write sections; add other content if needed Translates the requirements for a system into a detailed document Word document Complete the sections Describes how the system will perform and
Deployment Plan
DDS
FRS
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 16 of 23
Design and Build Phase will fulfill the requirements listed in the User Requirements Specification (URS) IP Installation Plan
Word document Write the sections; complete the tables Identifies what is to be installed and includes steps required for configuring or making operational: Hardware. Operating system, Storage, Databases, Application(s) / service(s), Other components Word document Complete the sections outlines the roles and the performance targets for every group involved in the delivery of the service Word document; Excel document Enter data into tables Provides the tools required for effective identification, assessment, and resolution of project issues PowerPoint or Word document Edit Template Provides a consistent, concise, update primarily meant for discussions or presentations; used for decisions by the project steering committee and/or project sponsor(s) PowerPoint or Visio document(s) Create new or edit existing examples Provides a visual schematic of the system
OLA
Status Report
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 17 of 23
Word document Write the sections Describes the objectives, scope, approach, and focus of a testing effort; details the type of testing: user acceptance and so forth Excel worksheet Enter data as appropriate Ensures that each URS requirement and its associated functional specifications are tracked through detail design specifications and are tested during the Testing Phase Word document Complete the tables Describes the training needed (if needed) and for whom the training is created
TM
Traceability Matrix
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 18 of 23
Word document Write the sections Verifies that the system was installed as intended and as described in the Installation Plan; provides documented evidence of the transition from intention to installation Word document or Excel worksheet Enter data Ensures completion of all activities and documentation needed for deployment Word document Write the sections Indicates that a system has been examined for all its requirements Word document Write the sections Documents that requirements have been tested; reports on variances found and resolved,; states that the test acceptance criteria have been met
Release Checklist
TS
Test Set(s)
TPSR
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 19 of 23
Excel worksheet Enter data into fields Examines expected against actual and asks if project was on-time, on-budget, onthe-mark Word document Write the sections Describes the results of the actions taken, actions that assure the system is validated according to established practices; captures the entire validation process; documents the test results; provides an analysis and conclusions that support the claim of system validation
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 20 of 23
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 21 of 23
2007 billgruener.com
Confidential and proprietary information. This document, nor any of its content, may be used, copied, stored (in hard copy or electronic form) without written permission from Bill Gruener.
Page 22 of 23
Business Case & TCO Project Charter Project Plan Project Schedule Project Snapshot Risk Management and
Assessment Plan Project Roles, Norms and Ground Rules
Release Checklist