Writing Software Requirements Specifications | A Technical Communication Community

Link: Writing Software Requirements Specifications | A Technical Communication Community

For technical writers who haven’t had the experience of designing software requirements specifications (SRSs, also known as software functional specifications or system specifications) templates or even writing SRSs, they might assume that being given the opportunity to do so is either a reward or punishment for something they did (or failed to do) on a previous project. Actually, SRSs are ideal projects for technical writers to be involved with because they lay out the foundation for the development of a new product and for the types of user documentation and media that will be required later in the project development life cycle. It also doesn’t hurt that you’d be playing a visible role in contributing to the success of the project.

This article will describe what an SRS is and why it’s important, discuss how and why technical writers should be involved with them, and discuss the critical elements for writing an SRS. Although this article does not attempt to address all aspects of developing SRSs, it aims to help you determine the scope for such a project, to provide some guidelines for writing SRSs, and to provide additional resources. Hopefully with this information, you’ll not be asking, “Why me?” but proclaiming “Why not me?”

Recent Entries

Overcoming resistance to change
This is a great little video on the causes and solutions to resistance to change in organizations.   It is…
What is the best way to embed a gallery in a Movable Type Site?
This post is slightly off topic for this blog, but I need help.  What is the best way for me…
The Collapse of Complex Business Models
Clay Shirky in his recent post "The Collapse of Complex Business Models", describes a well known business concept: substitution  Companies…
View Ralph Poole's profile on LinkedIn