Alphabet Soup – Requirements Documents

alphabet soup

This is my requirements document. There are many like it, but this one is mine. My requirements document is my life. [Kubrick, with some editing]. Michael provides a comparison of requirements documentation formats seen in the wild. A good companion to our earlier piece, Michael provides some “what to expect” guidance about how different companies use the different documentation formats. Check it out.

Background

There is a spectrum of specification for software projects, ranging from “vision” to “algorithm”, and all points in between.

We’ve described the software development process with an onion metaphor. Given that framework of ever-increasing-specificity, we’ve also looked at the flow of moving from market requirements to design, and proposed particular combinations of documents. The flow generally looks like the following:

Requirements flow

Michael’s Analysis

Michael looks in more detail at the “requirements” and “spec” levels in the above diagram and provides some perspective about how different companies approach and label documentation. One challenge – different companies use the same names to mean different things.

Check out Michael’s post – more good stuff from him (we subscribe and recommend his blog for everyone interested in product management)!

  • Scott Sehlhorst

    Scott Sehlhorst is a product management and strategy consultant with over 30 years of experience in engineering, software development, and business. Scott founded Tyner Blain in 2005 to focus on helping companies, teams, and product managers build better products. Follow him on LinkedIn, and connect to see how Scott can help your organization.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.