delivery focused 'documentation' in it services industry
DESCRIPTION
TRANSCRIPT
ANSHI BHADORIAAUGUST, 2012
‘Documentation’ in IT Services Industry
© Copyright Anshi Bhadoria
Agenda
Software Development Life Cycle (SDLC)Why documentationCMMI requirementsDocumentation across SDLCDocumentation in Agile environment
2© Copyright Anshi Bhadoria
LIFE CYCLE PHASES & ACTIVITIES
Software Development Life Cycle (SDLC)
3© Copyright Anshi Bhadoria
Software Development Life Cycle (SDLC)
SRS Design Develop SIT UAT Deploy
Software Development Life Cycle
Planning
Maintenance
4© Copyright Anshi Bhadoria
SDLC – Key Activities
SRS Design Develop SIT UAT Deploy
Requirement analysis and information gathering
Detailed project planning
High level and Low level design system architecture, components, interfaces, screens and database design
Code building and unit testing
Integrate distributed units
Test (techno functional) as a combined unit
User acceptance testing in the test environment
Code packaging
Deployment and roll-out to Production
55
These two stages involve most of the documentation in SDLC ! Which is a reference for
further stages.
© Copyright Anshi Bhadoria
WHY SO MUCH OF EMPHASIS ON DOCUMENTATION IN SOFTWARE
DEVELOPMENT ?
Why Documentation?
6© Copyright Anshi Bhadoria
7© Copyright Anshi Bhadoria
Why Documentation?
Agreement/ Sign-offsClarity/ Definitive/ Common formatKnowledge retention/transferReusability/ Code understandingRisk mitigationReference-ability/ traceabilityEliminate individual dependency
8© Copyright Anshi Bhadoria
Caveat
Configuration management (Document versioning)
Documentation standardsDocument overloadDocument authenticity
9© Copyright Anshi Bhadoria
10© Copyright Anshi Bhadoria
DOCUMENTS ACROSS SDLC FOR VARIOUS PURPOSES AND ADVANTAGES
Documentation across SDLC
11© Copyright Anshi Bhadoria
Documentation across SDLC
SRS docUAT test casesUAT acceptancecriteria
High level designSIT test plan & test casesLow level designUnit test cases
Updated unit test casesUpdated design documents
Updated system integrationtest plan/ test casesUser manualDeployment & roll out plan
Updated user acceptancetest cases
Updated documents based on UAT bug fixes
Updated deployment & roll out plan
PeerClient
PeerExternal
Peer External
PeerExternal
Peer ExternalClient
Successful build and deploy
SD
LC
S
TA
GE
SD
OC
UM
EN
TS
RE
VIE
W
TE
AM
S
12© Copyright Anshi Bhadoria
CMMI Requirements
PROCESS ORIENTED DOCUMENTATION TOWARDS LOWER RISK
13© Copyright Anshi Bhadoria
CMMI Capability Levels
14© Copyright Anshi Bhadoria
DOCUMENTATION IN AGILE ENVIRONMENT ENSURING QUALITY AND TIMELY
OUTCOMES
Agile Environment
15© Copyright Anshi Bhadoria
Manifesto for Agile Software Development
Individuals and interactions over processes and tools
Working software over comprehensive documentation
Customer collaboration over contract negotiation
Responding to change over following a plan
16© Copyright Anshi Bhadoria
Documentation in Agile Environment
Usage of Agile methodology doesn’t mean zero documentation
Agile just gives agility; flexibility to incorporate changing requirements
Agile very much involves facets of Project Management and Risk Management
17
Examples of documentation in Agile environment
• Use cases/ User stories• Technical architecture document• Design documents• Test cases/ UAT acceptance
criteria• System integration test plan• Others
© Copyright Anshi Bhadoria
© COPYRIGHT ANSHI BHADORIA
Thank you
18