Difference between revisions of "Requirement"
(→Functional (solution)) |
|||
(156 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | A [[requirement]] is an expressed demand, desire, expectation, and/or wish to have or not to have a certain capability, condition, feature, and/or property. The term, [[requirements]], may refer to the aggregate of various ''requirements'' that | + | A [[requirement]] is an expressed demand, desire, expectation, and/or wish to have or not to have a certain [[market exchangeable]] and/or a certain capability, condition, feature, and/or property. The plural term, [[requirements]], may refer to the aggregate of various ''requirements'' that the [[product owner]] or another authority for the ''requested product'' and/or its development [[process]] has approved, verified, and/or validated. Those ''requirements'' that limit the [[market exchangeable]]'s or [[process]] of the production's capabilities and/or conditions are called [[constraint]]s. |
==Definitions== | ==Definitions== | ||
+ | According to the [[ INCOSE Systems Engineering Handbook (4th edition)]], | ||
+ | :[[Requirement]]. A statement that identifies a system, product, or process characteristic or constraint, which is unambiguous, clear, unique, consistent, stand‐alone (not grouped), and verifiable, and is deemed necessary for stakeholder acceptability. | ||
− | ===Common | + | ===Common definitions=== |
:The common-style definitions particularly include: | :The common-style definitions particularly include: | ||
:*[[Requirement]]. Something that you must do, or something you need ([[Cambridge Dictionary]]). | :*[[Requirement]]. Something that you must do, or something you need ([[Cambridge Dictionary]]). | ||
:*[[Requirement]]. Something required such as (a) something wanted or needed or (b) something essential to the existence or occurrence of something else ([[Merriam-Webster]]). | :*[[Requirement]]. Something required such as (a) something wanted or needed or (b) something essential to the existence or occurrence of something else ([[Merriam-Webster]]). | ||
− | ===Engineering | + | ===Engineering definitions=== |
:According to the [[Rational Unified Process]] ([[Rational Unified Process|RUP]]), which is an iterative software development process framework that [[IBM]] markets, | :According to the [[Rational Unified Process]] ([[Rational Unified Process|RUP]]), which is an iterative software development process framework that [[IBM]] markets, | ||
::A [[requirement]] describes a condition or capability to which a system must conform; either derived directly from user needs, or stated in a contract, standard, specification, or other formally imposed document. | ::A [[requirement]] describes a condition or capability to which a system must conform; either derived directly from user needs, or stated in a contract, standard, specification, or other formally imposed document. | ||
Line 19: | Line 21: | ||
:The [[IEEE Standard Glossary of Software Engineering Terminology]] defines a ''requirement'' similarly to the two definitions above. | :The [[IEEE Standard Glossary of Software Engineering Terminology]] defines a ''requirement'' similarly to the two definitions above. | ||
+ | |||
+ | According to the [[BABOK Guide|BABOK Guide (3rd edition)]], | ||
+ | :[[Requirement]]. A usable representation of a need. | ||
+ | |||
+ | ===Stakeholder definitions=== | ||
+ | :From a [[stakeholder]] perspective, a [[requirement]] is anything that helps: | ||
+ | :#'''Customers''' to describe what they wish to obtain; | ||
+ | :#'''Suppliers''' to understand what the customer wants; | ||
+ | :#'''Requirements staffers''' to substantively develop requirements blueprints for their own organizations, as well as other [[requirements document]]s such as requirements quality checklists, requirements creator's handbooks, etc. | ||
==Applications== | ==Applications== | ||
Line 27: | Line 38: | ||
:*The [[International Institute of Business Analysis]] ([[International Institute of Business Analysis|IIBA]]) develops their [[A Guide to the Business Analysis Body of Knowledge]] ([[A Guide to the Business Analysis Body of Knowledge|BABOK Guide]]). The [[Certified Business Analysis Professional]] ([[Certified Business Analysis Professional|CBAP]]) certification that [[International Institute of Business Analysis|IIBA]] develops is based on that body of knowledge. | :*The [[International Institute of Business Analysis]] ([[International Institute of Business Analysis|IIBA]]) develops their [[A Guide to the Business Analysis Body of Knowledge]] ([[A Guide to the Business Analysis Body of Knowledge|BABOK Guide]]). The [[Certified Business Analysis Professional]] ([[Certified Business Analysis Professional|CBAP]]) certification that [[International Institute of Business Analysis|IIBA]] develops is based on that body of knowledge. | ||
:*The [[United States Department of Defense]] ([[United States Department of Defense|DOD]]) utilizes its own standards, which are largely derived from the [[Institute of Electrical and Electronics Engineers|IEEE]] standards. | :*The [[United States Department of Defense]] ([[United States Department of Defense|DOD]]) utilizes its own standards, which are largely derived from the [[Institute of Electrical and Electronics Engineers|IEEE]] standards. | ||
+ | |||
+ | ===New product development=== | ||
+ | :''Requirements'' for the [[market exchangeable]]s to be designed, developed, and delivered are in the core of [[new product development]]. [[Hewlett-Packard]] developed the [[FURPS]] system, which is quite popular in the software development and particularly promoted by [[IBM]]. The [[Agile methodology|Agile methodologi]]es widely use product ''requirements'' in forms of [[user story]], [[epic story]], and so on. | ||
===Procurement=== | ===Procurement=== | ||
− | :''Requirements'' for the [[ | + | :''Requirements'' for the [[market exchangeable]]s to be purchased are in the core of [[procurement]]. Forms of the procurement ''requirements'' range from oral statements such as ''I would like to buy the cheapest soap you carry'' and up to [[procurement statement of work|procurement statements of work]], [[business case]]s, etc. |
− | |||
− | |||
− | |||
===Project management=== | ===Project management=== | ||
Line 47: | Line 58: | ||
:*The [[International Council on Systems Engineering]] ([[International Council on Systems Engineering|INCOSE]]) leads endeavors to systematize practices related to ''requirements'' and develops their body of knowledge. The systems engineering professional certifications that [[International Council on Systems Engineering|INCOSE]] develops is based on that body of knowledge. | :*The [[International Council on Systems Engineering]] ([[International Council on Systems Engineering|INCOSE]]) leads endeavors to systematize practices related to ''requirements'' and develops their body of knowledge. The systems engineering professional certifications that [[International Council on Systems Engineering|INCOSE]] develops is based on that body of knowledge. | ||
− | == | + | ==Natural classifications== |
− | === | + | ===Categorized by audiences=== |
− | : | + | :''Requirements'' developers develop ''requirements''. There two major pairs of audiences that primarily consume those ''requirements'': |
− | : | + | :#''Customer and contractor'' when the ''requirements'' are needed to understand or confirm what needs to be done and, possibly, how what needs to be done would be done. |
− | : | + | :#''Contractor's management and implementing staffers'' when a set of ''requirements'' needs to be bettered and/or broken-down in order to be implemented by a contractor's team and/or subcontractors. This type of ''requirements'' is often called [[technical requirement]]s. |
===Categorized by imposing party=== | ===Categorized by imposing party=== | ||
:Any '''requirement''' can be imposed by one or more of the following three: | :Any '''requirement''' can be imposed by one or more of the following three: | ||
− | :#[[Customer]]; | + | :#[[Customer]], who states what is needed to be solved and, possibly, how what needs to be solved should be solved; |
− | :#[[Contractor]]; | + | :#[[Contractor]], who has its own circumstances, both resources and limitations; |
:#[[Third party]] such as: | :#[[Third party]] such as: | ||
:#*Government of any level including federal/national authorities such as the [[Internal Revenue Service]] ([[Internal Revenue Service|IRS]]) and [[Environmental Protection Agency]] ([[Environmental Protection Agency|EPA]]), regional authorities, and municipalities. This type of ''requirements'' may be called [[regulatory requirement]]s. | :#*Government of any level including federal/national authorities such as the [[Internal Revenue Service]] ([[Internal Revenue Service|IRS]]) and [[Environmental Protection Agency]] ([[Environmental Protection Agency|EPA]]), regional authorities, and municipalities. This type of ''requirements'' may be called [[regulatory requirement]]s. | ||
Line 63: | Line 74: | ||
:Some ''requirements'' are originated from the sources such as [[demographics]], [[economy]], and [[geography]] that are outside of those three, but they need to be brought to the [[operations]] or [[project]] by one of those three. | :Some ''requirements'' are originated from the sources such as [[demographics]], [[economy]], and [[geography]] that are outside of those three, but they need to be brought to the [[operations]] or [[project]] by one of those three. | ||
− | == | + | ===Categorized by progress=== |
+ | :''Requirements'' can be categorized based on their state in the [[requirement lifecycle]]: | ||
+ | :#'''[[Stated requirement]]'''. A requirement articulated by a stakeholder that has not been analyzed, verified, or validated. Stated requirements frequently reflect the desires of a stakeholder rather than the actual need. | ||
+ | :#[[Confirmed requirement]]. | ||
+ | :#[[Prioritized requirement]]. | ||
+ | :#[[Organized requirement]]. | ||
+ | :#[[Modeled requirement]]. | ||
+ | :#'''[[Verified requirement]]'''. Requirements that have been shown to demonstrate the characteristics of requirements quality and as such are cohesive, complete, consistent, correct, feasible, modifiable, unambiguous, and testable. | ||
+ | :#'''[[Validated requirement]]'''. A requirement that has been demonstrated to deliver business value and to support the business goals and objectives. | ||
+ | :#[[Reviewed requirement]]. | ||
+ | :#[[Approved requirement]]. | ||
+ | :#[[Implemented requirement]]. | ||
+ | |||
+ | ===Product vs process=== | ||
+ | :With regard to its nature, a ''requirement'' may refer to: | ||
+ | :*[[Product requirement]] that indicates a specific [[capacity]], condition, feature, functionality, and/or quality of the requested [[market exchangeable]]; | ||
+ | :*[[Transition requirement]] ([[process requirement]], [[project requirement]]) that indicates one or more specific ways of the ''requested product's'' design, development, delivery, and/or collection of feedback. | ||
+ | |||
+ | ==Modeled classifications== | ||
Because of the variety of research frameworks, a few competitive taxonomies exist. | Because of the variety of research frameworks, a few competitive taxonomies exist. | ||
− | + | ===IIBA-marketed taxonomy=== | |
− | |||
− | ===IIBA- | ||
:Particularly through their [[A Guide to the Business Analysis Body of Knowledge|BABOK Guide]], the [[International Institute of Business Analysis|IIBA]] markets the following taxonomy: | :Particularly through their [[A Guide to the Business Analysis Body of Knowledge|BABOK Guide]], the [[International Institute of Business Analysis|IIBA]] markets the following taxonomy: | ||
:#'''[[Business requirement]]'''. The highest level of the the [[International Institute of Business Analysis|IIBA]]'s hierarchy of ''requirements''. [[Business requirement]] is a business rationale for one or more changes that, when implemented, will permit the organization to increase revenue, avoid costs, improve service, or meet [[regulatory requirement]]s. The rationale commonly includes the organizational goals, objectives, and needs; it usually describes opportunities that an organization wants to realize or problems that they want to solve. A [[business case]] is the common form of a [[business requirement]]. | :#'''[[Business requirement]]'''. The highest level of the the [[International Institute of Business Analysis|IIBA]]'s hierarchy of ''requirements''. [[Business requirement]] is a business rationale for one or more changes that, when implemented, will permit the organization to increase revenue, avoid costs, improve service, or meet [[regulatory requirement]]s. The rationale commonly includes the organizational goals, objectives, and needs; it usually describes opportunities that an organization wants to realize or problems that they want to solve. A [[business case]] is the common form of a [[business requirement]]. | ||
:#'''[[Stakeholder requirement]]'''. Mid-level statements of the needs of a particular stakeholder or group of stakeholders. They usually describe how someone wants to interact with the intended solution. Often acting as a mid-point between the higher-level [[business requirement]]s and more detailed [[solution requirement]]s. | :#'''[[Stakeholder requirement]]'''. Mid-level statements of the needs of a particular stakeholder or group of stakeholders. They usually describe how someone wants to interact with the intended solution. Often acting as a mid-point between the higher-level [[business requirement]]s and more detailed [[solution requirement]]s. | ||
− | :#[[Solution requirement]], | + | :#'''[[Solution requirement]]''', including [[architecturally significant requirements]]. |
:#*[[Functional requirement]]. | :#*[[Functional requirement]]. | ||
:#*[[Non-functional requirement]]. | :#*[[Non-functional requirement]]. | ||
:#'''[[Transition requirement]]'''. The lowest level of the the [[International Institute of Business Analysis|IIBA]]'s hierarchy of ''requirements''. [[Transition requirement]]s are statements of capabilities or behavior required only to enable the transition from the current state of the enterprise to the desired future state, but that will thereafter no longer be required. Examples include recruitment, role changes, education, migration of data from one system to another. | :#'''[[Transition requirement]]'''. The lowest level of the the [[International Institute of Business Analysis|IIBA]]'s hierarchy of ''requirements''. [[Transition requirement]]s are statements of capabilities or behavior required only to enable the transition from the current state of the enterprise to the desired future state, but that will thereafter no longer be required. Examples include recruitment, role changes, education, migration of data from one system to another. | ||
− | |||
===FURPS+ system=== | ===FURPS+ system=== | ||
+ | :The [[FURPS|FURPS+]] system for requirements classification has been initially developed by Robert Grady at [[Hewlett-Packard]] and is now used widely in the [[industry]], most notably, by [[IBM]]. The acronym [[FURPS]] represents: | ||
+ | :#[[Functionality]] | ||
+ | :#[[Usability]] | ||
+ | :#[[Reliability]] | ||
+ | :#[[Performance]] | ||
+ | :#[[Supportability]] | ||
+ | |||
+ | :The "+" in [[FURPS|FURPS+]] indicates concerns related to design requirements, implementation requirements, interface requirements, and/or physical requirements. | ||
+ | |||
+ | ==Forms== | ||
+ | ===Artifacts=== | ||
+ | :Those artifacts that serve as ''requirements'' can be divided into two categories: | ||
+ | :#'''[[Concept artifact]]s''' such as [[wireframe]]s, [[mockup]]s, [[prototype]]s, etc. | ||
+ | :#'''Existing products''', especially competitor's ones. | ||
+ | |||
+ | ===Initiating documents=== | ||
+ | :*[[Agreement]]. | ||
+ | :*[[Contract]]. | ||
+ | :*[[Business case]]. | ||
+ | :*[[Procurement statement of work]]. | ||
+ | :*[[Product epic]]. | ||
+ | :*[[Regulatory document]]. | ||
+ | :*[[Statement of work]] ([[Statement of work|SOW]]). | ||
+ | |||
+ | ===Specifications=== | ||
+ | :''Main wikipage: [[Requirements specification]]'' | ||
+ | |||
+ | :#'''[[Business requirements document]]''' ([[Business requirements document|BRD]]). Also known as a Business Needs Specification, a BRD is the first stage in a product life cycle. It details the problems that a product/service/system is trying to solve by logically listing high-level business requirements in relation to customers’ needs. | ||
+ | :#'''[[Functional requirements document]]''' ([[Functional requirements document|FRD]]). An FRD defines in logical terms, how a system or project will accomplish the requirements laid out in the BRD. It outlines the functionality of the system in detail by capturing the intended behaviour of the system, expressed as services, tasks or functions that the developers have agreed to provide. | ||
+ | :#'''[[Market requirements document]]''' ([[Market requirements document|MRD]]). Sometimes referred to as a Marketing Requirements Document, an MRD focuses on the target market’s needs. It typically explains: What the product is, who the target customers are, what products are in competition with it and why customers are likely to want this product. | ||
+ | :#'''[[Product requirements document]]''' ([[Product requirements document|PRD]]). A PRD is used to communicate everything that must be included in a product release for it to be considered complete. It is written from a user’s point-of-view to understand what a product should do. It usually includes the same content as an FRD, but with ‘non-functional requirements’ added. Although non-functional requirements are not related to the functionality of the product, it’s often important to identify them - they may include such needs as reliability, security and scalability. | ||
+ | :#'''[[Quality requirements document]]'''. The quality requirements document outlines the expectations of the customer for the quality of the final product. It consists of various criteria, factors and metrics that must be satisfied. | ||
+ | :#'''[[Software requirements specification]]''' ([[Software requirements specification|SRS]]). An SRS outlines the features and the intended behaviour of a system. It describes the business’s understanding of the end user’s needs while laying out functional and nonfunctional requirements. | ||
+ | :#'''[[Technical requirements document]]''' ([[Technical requirements document|TRD]]). A TRD contains the software, hardware and platform requirements of the product. It includes requirements like the programming language the system should be developed in and the processor speed required to run the system. | ||
+ | :#'''[[User interface requirements document]]''' ([[User interface requirements document|UIRD]]). A UIRD describes the look and feel of the User Interface (UI) of the system. | ||
+ | :#'''[[User requirements document]]''' ([[User requirements document|URD]]). A requirements document written for a user audience, describing user requirements and the impact of the anticipated changes on the users. | ||
+ | |||
+ | ===Undocumented requests=== | ||
+ | |||
+ | ===Workteam documents=== | ||
+ | :To organize implementation of higher-level ''requirements'', [[workteam]]s casually use the following lower-level documents: | ||
+ | :*In the '''[[Agile methodology]]''': | ||
+ | :*#[[Product backlog]]. | ||
+ | :*#[[Sprint backlog]]. | ||
+ | :*#'''[[Epic story]]'''. A large [[user story]] that, in its current state, would be difficult to estimate or to complete in a single iteration. [[Epic story|Epic stori]]es are typically lower priority and are waiting be broken down into smaller components. | ||
+ | :*#'''[[User story]]'''. A high-level, informal, brief, non-technical description of a solution capability that provides value to a stakeholder. In other words, a [[user story]] is description of a system requirement written from the [[customer]]'s or [[end-user]]'s point of view. A [[user story]] is typically one or two sentences long and provides the minimum information necessary to allow a developer to estimate the work required to implement it. Either the [[product owner]] or the team writes [[user story|user stori]]es according to the following structure: as a [type of user], I want to [perform some task (or execute some function)], so I can [achieve some goal]. | ||
+ | :*In the '''[[Waterfall model]]''': | ||
+ | :*#[[Project task]]. | ||
+ | :*#[[Work order]]. | ||
+ | |||
+ | ==Process== | ||
+ | ===Analysis=== | ||
+ | :''Main wikipage: [[Business analysis]]'' | ||
+ | |||
+ | :[[Business analysis]] is the set of [[enterprise effort]]s and [[technique]]s used to work as a liaison among stakeholders in order to understand the structure, policies and operations of an [[enterprise]], its [[business need]]s, and recommend solutions that enable the ''enterprise'' to achieve its goals. [[Use case]]s are examples of those solutions. | ||
+ | |||
+ | ===Lifecycle=== | ||
+ | :''Main wikipage: [[Requirement lifecycle]]'' | ||
+ | |||
+ | :A [[requirement lifecycle]] is the cycle through which ''requirements'' tend to go through from their [[requirements collection|collection]] to [[requirements implementation|implementation]]. | ||
===MoSCoW method=== | ===MoSCoW method=== | ||
+ | :The MoSCoW method (alternatively known as MoSCoW analysis, MoSCoW prioritization) is a prioritization technique used in [[business analysis]], [[enterprise administration]], [[project management]], and [[new product development]] to reach a common understanding with stakeholders on the importance they place on the delivery of each requirement. | ||
+ | |||
+ | :The term, ''MoSCoW'', itself is an acronym derived from the first letter of each of four prioritization categories. Two interstitial ''O''s are added to make the word pronounceable: | ||
+ | :#'''M'''ust have. The ''must-have requirements'' are critical to the current sprint; missing any of them constitutes a project failure. | ||
+ | :#'''S'''hould have. The ''should-have requirements'' are important, but not necessary in the current sprint. | ||
+ | :#'''C'''ould have. The ''could-have'' requirements are desirable but not necessary and can be included if time and other resources permit. | ||
+ | :#'''W'''on't have at this time. The ''won't-have-this-time requirements'' are the least-critical, lowest-payback items, or not appropriate in the current sprint. | ||
− | === | + | ===Responsible staffers=== |
− | : | + | :The customers' needs are the origin of the project, so the customer is ultimately responsible for determining their requirement. Governments are responsible for regulations. Other [[third party|third parti]]es impose expectations, standards, etc. Within the contractor organization, the following staffers are casually involved in developments of ''requirements'', usually the [[technical requirement|technical one]]s: |
− | : | + | :#'''[[Business analyst]]'''. is responsible for discovering the problem/requirements and determining the solution. |
+ | :#'''[[Marketing manager]]'''. develops the marketing strategy for the project in line with its requirements. | ||
+ | :#'''[[Product manager]]'''. is responsible for defining the why, when, and what of the product that the development team will build. | ||
+ | :#'''[[Product owner]]'''. | ||
+ | :#'''[[Project manager]]'''. is responsible for delivering the solution to a problem. | ||
+ | :#'''[[Systems analyst]]'''. uses analysis and design to satisfy business requirements using information technology. | ||
+ | :#'''[[Team lead]]'''. | ||
− | === | + | ==Evaluation criteria== |
− | |||
− | == | + | ===Functional=== |
− | # | + | #Mobile client support |
− | # | + | #Content structuring: |
− | #* | + | #*Automatic updating of links to other pages when moved |
− | # | + | #*effort required to create a comprehensive structure |
− | #* | + | #*classifying content into subject categories |
− | #* | + | #*HTML Tags |
− | # | + | #Ease of use |
− | #* | + | #*Finding content |
− | #* | + | #*Navigating up and down, back and forth |
− | #* | + | #*Commenting: Discussion Pages or Threaded? |
− | #* | + | #Ease of content creation |
− | # | + | #*WYSIWYG editor |
− | #* | + | #*Quoting |
− | #* | + | #*Image Editing |
− | #* | + | #*SVG Editing |
− | # | + | #Ease of collaborative participation |
− | #* | + | #*Concurrent editing |
− | #* | + | #Content Management – Version tracking |
− | #* | + | #Modularity of installed components – Do they all have to be installed? If not, can they be installed at anytime? |
− | #* | + | #Additional functionality |
− | # | + | #*Full text search |
− | #* | + | #*Blogs/Forums |
− | #* | + | #*Email Notification |
− | # | + | #*Calendar |
− | #* | + | #*Structured data |
− | #* | + | #*Structured data trackers, analysis and report tools |
− | + | #*RSS Syndication | |
− | #* | + | #*File Galleries |
− | #* | + | #*Articles |
− | #* | + | #*FAQs |
− | # | + | #*Quizzes |
− | #* | + | #*Featured links |
− | #* | + | #*Slideshow |
− | #* | + | #*Messages |
− | # | + | #*Chat |
− | #* | + | #*Newsletters |
− | # | + | #*Shoutbox |
− | #* | + | #Dynamic Content |
+ | #Automatic Table of Contents | ||
+ | #Create links easily with other wikis | ||
+ | #Content Template | ||
+ | |||
+ | ===Non-functional=== | ||
+ | #Security | ||
+ | #*LDAP use built in or through plug-in | ||
+ | #*Back-end Authentication Methods Supported, e.g., OpenID, Active Directory, LDAP, Shibboleth, CAS, IMAP | ||
+ | #*ACL Support | ||
+ | #*User and Group Management granularity | ||
+ | #*Email encryption | ||
+ | #Wiki Release schedule | ||
+ | #Size of development community | ||
+ | #Extensible programming language | ||
+ | #Plug-in availability | ||
+ | #*Internal | ||
+ | #*External | ||
+ | #Import | ||
+ | #*From Media-wiki | ||
+ | #*From other sources | ||
+ | #Export to various formats | ||
+ | #Data store | ||
+ | #Programming languages supported | ||
+ | #Support | ||
+ | #*Forums | ||
+ | #*Mailing lists | ||
+ | #*Chat Channel | ||
− | |||
− | |||
==See also== | ==See also== | ||
*https://www.iiba.org/certification/iiba-certifications/#core | *https://www.iiba.org/certification/iiba-certifications/#core | ||
− | |||
*https://www.intechopen.com/books/interdisciplinary-approaches-to-semiotics/grounding-functional-requirements-classification-in-organizational-semiotics | *https://www.intechopen.com/books/interdisciplinary-approaches-to-semiotics/grounding-functional-requirements-classification-in-organizational-semiotics | ||
*https://www.cse.msu.edu/~cse870/IEEEXplore-SRS-template.pdf | *https://www.cse.msu.edu/~cse870/IEEEXplore-SRS-template.pdf | ||
*https://en.wikipedia.org/wiki/Software_requirements_specification | *https://en.wikipedia.org/wiki/Software_requirements_specification | ||
− | |||
*https://www.ibm.com/developerworks/rational/library/4706.html | *https://www.ibm.com/developerworks/rational/library/4706.html | ||
+ | *https://www.modernanalyst.com/Resources/Articles/tabid/115/ID/5464/9-Types-Of-Requirements-Documents-What-They-Mean-And-Who-Writes-Them.aspx | ||
*https://dzone.com/articles/remote-agile-part-1-practices-amp-tools | *https://dzone.com/articles/remote-agile-part-1-practices-amp-tools | ||
*https://dzone.com/articles/what-are-the-project-management-tools-that-are-use | *https://dzone.com/articles/what-are-the-project-management-tools-that-are-use | ||
− | [[Category: Septem Artes Administrativi]][[Category: Articles]] | + | ===Related lectures=== |
+ | :*[[Business Analysis Quarter]]. | ||
+ | :*[[What Requirements Are]]. | ||
+ | |||
+ | [[Category: Septem Artes Administrativi]][[Category: CNM Cyber Orientation]][[Category: Articles]][[Category: Business Analysis]][[Category: Systems Engineering]] |
Latest revision as of 13:35, 6 May 2023
A requirement is an expressed demand, desire, expectation, and/or wish to have or not to have a certain market exchangeable and/or a certain capability, condition, feature, and/or property. The plural term, requirements, may refer to the aggregate of various requirements that the product owner or another authority for the requested product and/or its development process has approved, verified, and/or validated. Those requirements that limit the market exchangeable's or process of the production's capabilities and/or conditions are called constraints.
Contents
Definitions
According to the INCOSE Systems Engineering Handbook (4th edition),
- Requirement. A statement that identifies a system, product, or process characteristic or constraint, which is unambiguous, clear, unique, consistent, stand‐alone (not grouped), and verifiable, and is deemed necessary for stakeholder acceptability.
Common definitions
- The common-style definitions particularly include:
- Requirement. Something that you must do, or something you need (Cambridge Dictionary).
- Requirement. Something required such as (a) something wanted or needed or (b) something essential to the existence or occurrence of something else (Merriam-Webster).
Engineering definitions
- According to the Rational Unified Process (RUP), which is an iterative software development process framework that IBM markets,
- A requirement describes a condition or capability to which a system must conform; either derived directly from user needs, or stated in a contract, standard, specification, or other formally imposed document.
- According to the second version of the A Guide to the Business Analysis Body of Knowledge® (BABOK Guide), a requirement is:
- A condition or capability needed by a stakeholder to solve a problem or achieve an objective;
- A condition or capability that must be met of possessed by a deliverable or its component to satisfy a contract, standard, specification, or other formally imposed documents; AND/OR
- A documented representation of a condition or capability as in (1) or (2).
- The IEEE Standard Glossary of Software Engineering Terminology defines a requirement similarly to the two definitions above.
According to the BABOK Guide (3rd edition),
- Requirement. A usable representation of a need.
Stakeholder definitions
- From a stakeholder perspective, a requirement is anything that helps:
- Customers to describe what they wish to obtain;
- Suppliers to understand what the customer wants;
- Requirements staffers to substantively develop requirements blueprints for their own organizations, as well as other requirements documents such as requirements quality checklists, requirements creator's handbooks, etc.
Applications
Requirements are widely used in business analysis, process optimization, procurement, product development, project management, systems engineering, and many other areas. Because of variety of applications, several views of what requirements are, how they should be organized and how they should be utilized compete against each other.
Business analysis
- Requirements for the solutions to be designed, developed, and delivered are in the core of business analysis.
- The International Institute of Business Analysis (IIBA) develops their A Guide to the Business Analysis Body of Knowledge (BABOK Guide). The Certified Business Analysis Professional (CBAP) certification that IIBA develops is based on that body of knowledge.
- The United States Department of Defense (DOD) utilizes its own standards, which are largely derived from the IEEE standards.
New product development
- Requirements for the market exchangeables to be designed, developed, and delivered are in the core of new product development. Hewlett-Packard developed the FURPS system, which is quite popular in the software development and particularly promoted by IBM. The Agile methodologies widely use product requirements in forms of user story, epic story, and so on.
Procurement
- Requirements for the market exchangeables to be purchased are in the core of procurement. Forms of the procurement requirements range from oral statements such as I would like to buy the cheapest soap you carry and up to procurement statements of work, business cases, etc.
Project management
- Requirements for the unique product, service, or result to be designed, created, and delivered are in the core of project management. AXELOS Ltd and the PMI lead the industry research on requirements.
- AXELOS Ltd, which is a joint venture by the United Kingdom Cabinet Office and Capita Plc, markets its PRINCE2. The name of this structured project management method and practitioner certification programme stands for PRojects IN Controlled Environments.
- The Project Management Institute (PMI) markets its Project Management Body of Knowledge (PMBOK). The professional certifications such as Project Management Professional (PMP) that PMI develops are based on that body of knowledge.
Sales engineering
- Requirements for the products to be sold are in the core of sales engineering. Regardless of the fact whether anyone in marketing and sales knows what the term, requirement, means, any good sales representative asks a potential buyer about what he or she wants to buy at least and, probably, on what conditions and at what price.
Systems engineering
- Requirements for the systems to be designed, developed, and delivered are in the core of systems engineering. The IEEE and the INCOSE lead the industry research on requirements.
- The Institute of Electrical and Electronics Engineers (IEEE) markets its software requirements specification (SRS), which is a description of a software system to be developed. SRS is also a part of the concept of operations (CONOPS), IEEE Standard Glossary of Software Engineering Terminology, and Software Engineering Body of Knowledge (SWEBOK) that the IEEE develops.
- The International Council on Systems Engineering (INCOSE) leads endeavors to systematize practices related to requirements and develops their body of knowledge. The systems engineering professional certifications that INCOSE develops is based on that body of knowledge.
Natural classifications
Categorized by audiences
- Requirements developers develop requirements. There two major pairs of audiences that primarily consume those requirements:
- Customer and contractor when the requirements are needed to understand or confirm what needs to be done and, possibly, how what needs to be done would be done.
- Contractor's management and implementing staffers when a set of requirements needs to be bettered and/or broken-down in order to be implemented by a contractor's team and/or subcontractors. This type of requirements is often called technical requirements.
Categorized by imposing party
- Any requirement can be imposed by one or more of the following three:
- Customer, who states what is needed to be solved and, possibly, how what needs to be solved should be solved;
- Contractor, who has its own circumstances, both resources and limitations;
- Third party such as:
- Government of any level including federal/national authorities such as the Internal Revenue Service (IRS) and Environmental Protection Agency (EPA), regional authorities, and municipalities. This type of requirements may be called regulatory requirements.
- Industry constituencies such as competitors, labor organizations, engineering organizations, owners of intellectual property, etc.
- Some requirements are originated from the sources such as demographics, economy, and geography that are outside of those three, but they need to be brought to the operations or project by one of those three.
Categorized by progress
- Requirements can be categorized based on their state in the requirement lifecycle:
- Stated requirement. A requirement articulated by a stakeholder that has not been analyzed, verified, or validated. Stated requirements frequently reflect the desires of a stakeholder rather than the actual need.
- Confirmed requirement.
- Prioritized requirement.
- Organized requirement.
- Modeled requirement.
- Verified requirement. Requirements that have been shown to demonstrate the characteristics of requirements quality and as such are cohesive, complete, consistent, correct, feasible, modifiable, unambiguous, and testable.
- Validated requirement. A requirement that has been demonstrated to deliver business value and to support the business goals and objectives.
- Reviewed requirement.
- Approved requirement.
- Implemented requirement.
Product vs process
- With regard to its nature, a requirement may refer to:
- Product requirement that indicates a specific capacity, condition, feature, functionality, and/or quality of the requested market exchangeable;
- Transition requirement (process requirement, project requirement) that indicates one or more specific ways of the requested product's design, development, delivery, and/or collection of feedback.
Modeled classifications
Because of the variety of research frameworks, a few competitive taxonomies exist.
IIBA-marketed taxonomy
- Particularly through their BABOK Guide, the IIBA markets the following taxonomy:
- Business requirement. The highest level of the the IIBA's hierarchy of requirements. Business requirement is a business rationale for one or more changes that, when implemented, will permit the organization to increase revenue, avoid costs, improve service, or meet regulatory requirements. The rationale commonly includes the organizational goals, objectives, and needs; it usually describes opportunities that an organization wants to realize or problems that they want to solve. A business case is the common form of a business requirement.
- Stakeholder requirement. Mid-level statements of the needs of a particular stakeholder or group of stakeholders. They usually describe how someone wants to interact with the intended solution. Often acting as a mid-point between the higher-level business requirements and more detailed solution requirements.
- Solution requirement, including architecturally significant requirements.
- Transition requirement. The lowest level of the the IIBA's hierarchy of requirements. Transition requirements are statements of capabilities or behavior required only to enable the transition from the current state of the enterprise to the desired future state, but that will thereafter no longer be required. Examples include recruitment, role changes, education, migration of data from one system to another.
FURPS+ system
- The FURPS+ system for requirements classification has been initially developed by Robert Grady at Hewlett-Packard and is now used widely in the industry, most notably, by IBM. The acronym FURPS represents:
- The "+" in FURPS+ indicates concerns related to design requirements, implementation requirements, interface requirements, and/or physical requirements.
Forms
Artifacts
- Those artifacts that serve as requirements can be divided into two categories:
- Concept artifacts such as wireframes, mockups, prototypes, etc.
- Existing products, especially competitor's ones.
Initiating documents
Specifications
- Main wikipage: Requirements specification
- Business requirements document (BRD). Also known as a Business Needs Specification, a BRD is the first stage in a product life cycle. It details the problems that a product/service/system is trying to solve by logically listing high-level business requirements in relation to customers’ needs.
- Functional requirements document (FRD). An FRD defines in logical terms, how a system or project will accomplish the requirements laid out in the BRD. It outlines the functionality of the system in detail by capturing the intended behaviour of the system, expressed as services, tasks or functions that the developers have agreed to provide.
- Market requirements document (MRD). Sometimes referred to as a Marketing Requirements Document, an MRD focuses on the target market’s needs. It typically explains: What the product is, who the target customers are, what products are in competition with it and why customers are likely to want this product.
- Product requirements document (PRD). A PRD is used to communicate everything that must be included in a product release for it to be considered complete. It is written from a user’s point-of-view to understand what a product should do. It usually includes the same content as an FRD, but with ‘non-functional requirements’ added. Although non-functional requirements are not related to the functionality of the product, it’s often important to identify them - they may include such needs as reliability, security and scalability.
- Quality requirements document. The quality requirements document outlines the expectations of the customer for the quality of the final product. It consists of various criteria, factors and metrics that must be satisfied.
- Software requirements specification (SRS). An SRS outlines the features and the intended behaviour of a system. It describes the business’s understanding of the end user’s needs while laying out functional and nonfunctional requirements.
- Technical requirements document (TRD). A TRD contains the software, hardware and platform requirements of the product. It includes requirements like the programming language the system should be developed in and the processor speed required to run the system.
- User interface requirements document (UIRD). A UIRD describes the look and feel of the User Interface (UI) of the system.
- User requirements document (URD). A requirements document written for a user audience, describing user requirements and the impact of the anticipated changes on the users.
Undocumented requests
Workteam documents
- To organize implementation of higher-level requirements, workteams casually use the following lower-level documents:
- In the Agile methodology:
- Product backlog.
- Sprint backlog.
- Epic story. A large user story that, in its current state, would be difficult to estimate or to complete in a single iteration. Epic stories are typically lower priority and are waiting be broken down into smaller components.
- User story. A high-level, informal, brief, non-technical description of a solution capability that provides value to a stakeholder. In other words, a user story is description of a system requirement written from the customer's or end-user's point of view. A user story is typically one or two sentences long and provides the minimum information necessary to allow a developer to estimate the work required to implement it. Either the product owner or the team writes user stories according to the following structure: as a [type of user], I want to [perform some task (or execute some function)], so I can [achieve some goal].
- In the Waterfall model:
- In the Agile methodology:
Process
Analysis
- Main wikipage: Business analysis
- Business analysis is the set of enterprise efforts and techniques used to work as a liaison among stakeholders in order to understand the structure, policies and operations of an enterprise, its business needs, and recommend solutions that enable the enterprise to achieve its goals. Use cases are examples of those solutions.
Lifecycle
- Main wikipage: Requirement lifecycle
- A requirement lifecycle is the cycle through which requirements tend to go through from their collection to implementation.
MoSCoW method
- The MoSCoW method (alternatively known as MoSCoW analysis, MoSCoW prioritization) is a prioritization technique used in business analysis, enterprise administration, project management, and new product development to reach a common understanding with stakeholders on the importance they place on the delivery of each requirement.
- The term, MoSCoW, itself is an acronym derived from the first letter of each of four prioritization categories. Two interstitial Os are added to make the word pronounceable:
- Must have. The must-have requirements are critical to the current sprint; missing any of them constitutes a project failure.
- Should have. The should-have requirements are important, but not necessary in the current sprint.
- Could have. The could-have requirements are desirable but not necessary and can be included if time and other resources permit.
- Won't have at this time. The won't-have-this-time requirements are the least-critical, lowest-payback items, or not appropriate in the current sprint.
Responsible staffers
- The customers' needs are the origin of the project, so the customer is ultimately responsible for determining their requirement. Governments are responsible for regulations. Other third parties impose expectations, standards, etc. Within the contractor organization, the following staffers are casually involved in developments of requirements, usually the technical ones:
- Business analyst. is responsible for discovering the problem/requirements and determining the solution.
- Marketing manager. develops the marketing strategy for the project in line with its requirements.
- Product manager. is responsible for defining the why, when, and what of the product that the development team will build.
- Product owner.
- Project manager. is responsible for delivering the solution to a problem.
- Systems analyst. uses analysis and design to satisfy business requirements using information technology.
- Team lead.
Evaluation criteria
Functional
- Mobile client support
- Content structuring:
- Automatic updating of links to other pages when moved
- effort required to create a comprehensive structure
- classifying content into subject categories
- HTML Tags
- Ease of use
- Finding content
- Navigating up and down, back and forth
- Commenting: Discussion Pages or Threaded?
- Ease of content creation
- WYSIWYG editor
- Quoting
- Image Editing
- SVG Editing
- Ease of collaborative participation
- Concurrent editing
- Content Management – Version tracking
- Modularity of installed components – Do they all have to be installed? If not, can they be installed at anytime?
- Additional functionality
- Full text search
- Blogs/Forums
- Email Notification
- Calendar
- Structured data
- Structured data trackers, analysis and report tools
- RSS Syndication
- File Galleries
- Articles
- FAQs
- Quizzes
- Featured links
- Slideshow
- Messages
- Chat
- Newsletters
- Shoutbox
- Dynamic Content
- Automatic Table of Contents
- Create links easily with other wikis
- Content Template
Non-functional
- Security
- LDAP use built in or through plug-in
- Back-end Authentication Methods Supported, e.g., OpenID, Active Directory, LDAP, Shibboleth, CAS, IMAP
- ACL Support
- User and Group Management granularity
- Email encryption
- Wiki Release schedule
- Size of development community
- Extensible programming language
- Plug-in availability
- Internal
- External
- Import
- From Media-wiki
- From other sources
- Export to various formats
- Data store
- Programming languages supported
- Support
- Forums
- Mailing lists
- Chat Channel
See also
- https://www.iiba.org/certification/iiba-certifications/#core
- https://www.intechopen.com/books/interdisciplinary-approaches-to-semiotics/grounding-functional-requirements-classification-in-organizational-semiotics
- https://www.cse.msu.edu/~cse870/IEEEXplore-SRS-template.pdf
- https://en.wikipedia.org/wiki/Software_requirements_specification
- https://www.ibm.com/developerworks/rational/library/4706.html
- https://www.modernanalyst.com/Resources/Articles/tabid/115/ID/5464/9-Types-Of-Requirements-Documents-What-They-Mean-And-Who-Writes-Them.aspx
- https://dzone.com/articles/remote-agile-part-1-practices-amp-tools
- https://dzone.com/articles/what-are-the-project-management-tools-that-are-use