SRS Documentation Skill

Overview

This skill provides guidance for creating formal Software Requirements Specification (SRS) documents following the IEEE 830 standard structure.

IEEE 830 Standard Structure

1. Introduction

1.1 Purpose

• State the purpose of the SRS document
• Identify the intended audience
• Specify the scope of coverage

1.2 Scope

• Identify the software product by name
• Explain what the software will do
• Describe application benefits, objectives, goals
• Be consistent with related higher-level specs

1.3 Definitions, Acronyms, and Abbreviations

• Define all terms used in the document
• Include technical terms, acronyms, abbreviations
• Reference glossary or appendix if extensive

1.4 References

• List all referenced documents
• Include document titles, numbers, dates, sources
• Identify version or revision information

1.5 Overview

• Describe document organization
• Explain the structure of remaining sections

2. Overall Description

2.1 Product Perspective

• System Context: How the product fits into the larger ecosystem
• System Interfaces: Connections to other systems
• User Interfaces: UI considerations and constraints
• Hardware Interfaces: Required hardware connections
• Software Interfaces: Required software connections
• Communications Interfaces: Network and protocol requirements
• Memory Constraints: Memory and storage limitations
• Operations: Normal and special operations modes
• Site Adaptation Requirements: Installation and deployment needs

2.2 Product Functions

• Summary of major functions
• High-level feature overview
• Organized by user or business function

2.3 User Characteristics

• General characteristics of intended users
• Educational level, experience, technical expertise
• Accessibility considerations

2.4 Constraints

• Regulatory requirements
• Hardware limitations
• Interface requirements
• Standards compliance
• Security considerations

2.5 Assumptions and Dependencies

• Factors assumed to be true
• Dependencies on other systems or components
• Conditions that if changed would affect requirements

3. Specific Requirements

3.1 External Interface Requirements

• User Interfaces: Detailed UI specifications
• Hardware Interfaces: Hardware interaction details
• Software Interfaces: API and integration details
• Communications Interfaces: Protocol specifications

3.2 Functional Requirements

Organized by:

• Feature or function
• User class
• Business object
• Mode of operation
• Stimulus/response sequence

Each requirement should include:

• Unique identifier (FR-XXX)
• Description of functionality
• Inputs and outputs
• Processing logic
• Error handling

3.3 Performance Requirements

• Response time requirements
• Throughput requirements
• Capacity requirements
• Resource utilization limits

3.4 Design Constraints

• Standards compliance
• Hardware limitations
• Software constraints
• Architectural requirements

3.5 Software System Attributes

• Reliability: Mean time between failures, recovery
• Availability: Uptime requirements
• Security: Access control, data protection
• Maintainability: Modification ease, documentation
• Portability: Platform requirements

3.6 Other Requirements

• Database requirements
• Operations requirements
• Internationalization requirements

4. Appendices

A. Glossary

Complete list of defined terms

B. Analysis Models

• Data flow diagrams
• Entity-relationship diagrams
• State diagrams
• Use case diagrams

C. Requirements Traceability Matrix

• Maps requirements to business objectives
• Maps requirements to test cases
• Shows requirement dependencies

Writing Guidelines

Requirement Characteristics

Each requirement should be:

| Characteristic | Description | Example | |---------------|-------------|---------| | Necessary | Needed for system success | Not nice-to-have | | Unambiguous | Single interpretation | "User" defined specifically | | Complete | All information included | Includes error scenarios | | Consistent | No conflicts | Aligns with other requirements | | Verifiable | Can be tested | Measurable criteria | | Traceable | Has clear origin | Links to business need | | Modifiable | Can be changed easily | Unique ID, no redundancy | | Prioritized | Ranked by importance | MoSCoW classification |

Requirement Writing Style

DO:

• Use "shall" for mandatory requirements
• Use "should" for desirable requirements
• Use "may" for optional requirements
• Be specific and quantitative
• Use consistent terminology
• Write in active voice
• One requirement per statement

DON'T:

• Use vague terms (fast, user-friendly, flexible)
• Use negative requirements when possible
• Combine multiple requirements
• Include design/implementation details
• Use inconsistent terminology

Examples

Good Requirement:

FR-001: The system shall display search results within 3 seconds
of the user submitting a search query.

Bad Requirement:

The system should be fast and display results quickly.

Requirement ID Conventions

Functional Requirements

FR-XXX: Core functional requirements
FR-AUTH-XXX: Authentication related
FR-RPT-XXX: Reporting related
FR-INT-XXX: Integration related

Non-Functional Requirements

NFR-PERF-XXX: Performance
NFR-SEC-XXX: Security
NFR-REL-XXX: Reliability
NFR-USA-XXX: Usability
NFR-MAINT-XXX: Maintainability

Constraints

CON-XXX: General constraints
CON-REG-XXX: Regulatory constraints
CON-TECH-XXX: Technical constraints

Priority Levels

MoSCoW Method

| Priority | Code | Description | |----------|------|-------------| | Must Have | M | Critical for success | | Should Have | S | Important but not critical | | Could Have | C | Nice to have | | Won't Have | W | Out of scope for this release |

Risk-Based Priority

| Priority | Level | Description | |----------|-------|-------------| | Critical | P1 | System cannot function without | | High | P2 | Major feature impacted | | Medium | P3 | Minor feature impacted | | Low | P4 | Enhancement or convenience |

Document Formatting

Section Numbering

1. Introduction
   1.1 Purpose
   1.2 Scope
2. Overall Description
   2.1 Product Perspective

Requirement Tables

| ID | Description | Priority | Status | Source |
|----|-------------|----------|--------|--------|
| FR-001 | User login | M | Approved | Stakeholder Meeting 2024-01-15 |

Cross-References

• Use hyperlinks within document
• Reference by ID: "See FR-001"
• Include traceability: "Implements BR-003"

Validation Checklist

Before finalizing SRS, verify:

• [ ] All sections of IEEE 830 template completed
• [ ] All requirements have unique identifiers
• [ ] All requirements are verifiable
• [ ] No conflicting requirements
• [ ] All terms defined in glossary
• [ ] Traceability matrix complete
• [ ] Stakeholder sign-off obtained
• [ ] Version control and change history included

See template.md for the complete SRS template. See checklists.md for validation checklists.