Worth considering before you embark on another 100 page opus:

• No Premium on Brevity

The overall flow of deliverables is as follows:

Note:Some of the above steps run parrallel (BRD and URD for example)

• BCD:Business Case Document
• Project Initiation Agenda
• Resources: Feasibility Study
• Project Cost/Benefit Analysis
• Project or Issue Submission Form
• Project Team Definition
• Initiate Project CheckList

• Project Charter
• IT:AD:Documentation:SOW
• Project Approval Document
• Cost Estimation Worksheet
• Development Estimate Worksheet
• Project Capital v. Expense Costs
• Project Risk Analysis
• Procurement Plan
• Project Organisation Chart
• Roles and Responsibilities Matrix
• Required Approvals Matrix
• COBIT Checklist and Reviews
• IT:AD:Documentation:Request for Information (RFI)
• Root Cause Analysis
• Project Plan
• IT:AD:Documentation:BRD: Document what is required to add value to a Business.

The Client has to do some Discovery of its own Business needs before it Decides it wants to solicite for a provider to develop the solution.

• IT:AD:Documentation:URD
• IT:AD:Documentation:Project Charter: “Project Charter”
• IT:AD:Documentation:Request for Information (RFI): “Request for Information” about a service company and its capabilities/suitability for an upcoming proposal.
• IT:AD:Documentation:RFP (Request for Proposal): “Request for Proposal”: sent to vetted venders to submit a proposal on a specific project.
  • The RFP might also entail a:

    • Options Summary: “Options Analysis Document”/Summary/Paper

    * IT:AD:Documentation:RFQ: “Request for Quote” on a specified project implementation.

• MA: “Master Agreement” agreement between client and vendor.
• IT:AD:Documentation:SOW: “Statement of Work” agreement between client and vendor.

The vendor has Discover the needs of the Client/.

• FRD: “Functional Requirements Document”
• NFRD: “Non-Functional Requirements Document”
• SRS: “Software Requirements Specifications”
• IT:AD:Documentation:Architecture Description Document (ADD): “Architecture Definition Document”
• IT:AD:Documentation:Solution Architecture Description (SAD) Document: “Solution Architecture Description”
  • IT:AD:Documentation:SDD (Solution/Application Design Document): a more succinct equivalent of the IT:AD:Documentation:Solution Architecture Description (SAD) Document.
    • In an agile project, this is developed/updated as one develops the solution.
• IT:AD:Documentation:TDD: “Technical Design Document(s)“
• IT:AD:Documentation:Test Summary Report (TSR): “Test Summary Report” Document TSR
• PMD: “Post Mordem Document”
• Glossary

Requirements should be:

• Correct
• Unambiguous
• Complete
• Consistent
• Ranked for importance and/or stability
• Verifiable
• Modifiable
• Traceable

Templates:

• [Requirements Specifications] (http://www.volere.co.uk/template.htm)

Even in the IT:AD:Development phase, in addition to the actual solution being produced, there are related documents.

These are:

• IT:AD:Documentation:SDD (Solution/Application Design Document): a more succinct equivalent of the IT:AD:Documentation:Solution Architecture Description (SAD) Document.
  • In an agile project, this is developed/updated as one develops the solution.
• IT:AD:Documentation:RFC:Request for Change: “Request For Change” to handle additional requirements that were not captured during the IT:AD:Discovery / IT:AD:Define phases.
• IT:AD:Documentation:Static Analysis Report: An optional report on a Static Code Analysis. Covers several concepts (security, complexity, etc.)
• IT:AD:Documentation:Design:
• HIG:Human Interface Guidelines.
• UIG:User Interface Guidelines.
• Testing Deliverables:
  • Test cases Documents
  • Test Plan
  • Testing Strategy
  • Test Scripts
  • Test Data

• IT:AD:Documentation:Implementation: A summary of the application architecture, infrastructure requirements, settings. Of use by 2nd level support/.
• Testing:
  • Test Trace-ability Matrix
  • Test Results/reports
  • Test summary report
  • Install/config guides
  • IT:AD:Documentation:Defect Report Document: “Defect Report Document”
  • RND: “Release Notes Document”
• IT:AD:Documentation:DP (Deployment Plan)

After it's been Deployed, Declare it's ready. Promote Organisational Awareness. Get the Word out.

*.docx Template

• http://getsp.sbisite.com/SBI/IT/Shared%20Documents/IT%20FuncSpec.pdf
• http://www.sdlcforms.com/Side-By-SideComparisonForms.html

• (UP)

  • IT - Documentation - Specification
    • IT:PM:Docs/Specifications/IO
  • IT/AD/Documentation:Briefing Paper
  • IT::AD:Documentation:Examples
    • frd (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
    • IT::AD:Documentation:Examples:1
  • IT:AD:Documentation:Architecture Description Document (ADD)
  • IT:AD:Documentation:BRD
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:Business Canvas
  • IT:AD:Documentation:Closure Report (CR)
  • IT:AD:Documentation:Decision Paper
  • IT:AD:Documentation:Defect Report Document
  • IT:AD:Documentation:Deployment
    • document
  • IT:AD:Documentation:Discussion Document
  • IT:AD:Documentation:DP (Deployment Plan)
  • IT:AD:Documentation:Fact Sheet
  • IT:AD:Documentation:Green Paper
  • IT:AD:Documentation:HowTo
    • IT:AD:Documentation:HowTo:Abstract, Summary, Introduction, Etc.
    • IT:AD:Documentation:HowTo:Standard Document Structure
    • IT:AD:Documentation:HowTo:Common Enterprise Editing Tips
  • IT:AD:Documentation:Information Paper
  • IT:AD:Documentation:Issue Paper
  • IT:AD:Documentation:Meetings
    • IT:AD:Documentation:Meeting:Minutes
    • IT:AD:Documentation:Meetings:Agenda
  • IT:AD:Documentation:Onboarding Document
  • IT:AD:Documentation:Options Paper
  • IT:AD:Documentation:Project Brief
  • IT:AD:Documentation:Request for Information (RFI)
  • IT:AD:Documentation:RFC:Request for Change
  • IT:AD:Documentation:RFP (Request for Proposal)
  • IT:AD:Documentation:RFQ
  • it:ad:documentation:scientific_paper:Home
  • IT:AD:Documentation:SDD (Solution/Application Design Document)
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:Software Requirements Specification (SRS) Document
  • IT:AD:Documentation:Solution Architecture Description (SAD) Document
    • IT:AD:Documentation:SAD:Examples
    • IT:AD:Documentation:SAD:Rozanski and Woods (RaW)
  • IT:AD:Documentation:SOW
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:TDD
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:Terms of Reference (TOR)
  • IT:AD:Documentation:Test Summary Report (TSR)
  • IT:AD:Documentation:URD
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:Vision Document (VD)
  • IT:AD:Documentation:White Paper
  • IT:PM:Documentation:Diagrams
    • Overall
  • NFRD
    • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • Options Summary
  • Resources
  • home (WIN-QNKB1B7TQET's conflicted copy 2016-09-15)
  • IT:AD:Documentation:Design
  • IT:AD:Documentation:Implementation
  • IT:AD:Documentation:Options Statement
  • IT:AD:Documentation:Project Charter
  • IT:AD:Documentation:Questions
  • IT:AD:Documentation:Static Analysis Report

Commercial:

• RFI: Request for Information about a service company and its capabilities/suitability for an upcoming proposal.
• RFP: Request for Proposal
• RFQ
• Statement of Work (SOW)

Analysis:

• Business Requirements Document (BRD):Document what is required to add value to a Business.
• Specifications
• Functional
• Non-Functional
• MOU

Production:

• RFC Request For Change

Testing:

• StaticAnalysisReport
• SRSD
• Implementation
• Design
• Glossary

*.docx Template

http://getsp.sbisite.com/SBI/IT/Shared%20Documents/IT%20FuncSpec.pdf

* Summary * Project Description * Option Assessment

• Options 1-n
  • SWOT

* Describe in terms of Business, not technology

* Strength * Weaknesses * Opportunities * Threats

[Requirements Specifications] (http://www.volere.co.uk/template.htm)

• Functionality [Biz Caps, Security]
• Usability [Human Factors, Accessibility, Consistency, Aesthetics, Documentation]
• Reliablity [FailureRatio, Severity, Recoverabiltiy, Predictabilty, Accuracy]
• Performance [Responsiveness, Throughput, Speed, Resource Consumption,
• Supportability [Testability, Extensibility, Adaptability, Maintainability, Compatibility, Configurability, Serviceability, Installability, Localizability, Portability]

• Correct
• Unambiguous
• Complete
• Consistent
• Ranked for importance and/or stability
• Verifiable
• Modifiable
• Traceable