TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
RE: Where are the limits of Business Requirements Documents / Software Requirements Specifications?
Subject:RE: Where are the limits of Business Requirements Documents / Software Requirements Specifications? From:"David Artman" <david -at- davidartman -dot- com> To:"Uwe Ziegenhagen" <ziegenhagen -at- gmail -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com Date:Thu, 05 Feb 2015 15:00:42 -0700
I imagine it's company/culture-specific, but I usually see:
* Marketing Requirements = What the function must do; e.g., "Allow for
printing 2D bar codes on shipping labels".
* Business Case = Whether the function is worth the cost; will it earn
revenue or increase market share or loyalty.
* Functional Specification = How the software will execute the
requirement; UI elements to support it; messages, erros, and logging;
tools develpment; user stories/use cases/mockups.
* Project Plan = Usually a collection of several of the above tied to a
release; time lines, resource and space allocations; factory floor
reworks; steering group/project team/project sponsor/black-belt.
Sometimes there's a tiny bit of overlap between MR and FS, but usually
only if a customer has specific request a certain way of doing the
function (e.g., "Make a button that shuts down all of your
company's software, so I don't have to click fifteen close buttons").
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015