Writing eliciting good rqmts 082311


Published on

Published in: Technology, Business
1 Like
  • Be the first to comment

No Downloads
Total views
On SlideShare
From Embeds
Number of Embeds
Embeds 0
No embeds

No notes for slide

Writing eliciting good rqmts 082311

  1. 1. Writing and Eliciting Good RequirementsMichelle Specht<br />7/23/2011<br />
  2. 2. 2<br />Agenda<br />The Importance of Good Requirements<br />The Challenges of Developing Good Requirements<br />Writing Requirements <br />Requirements Elicitation <br />Using Requirements Management tools<br />
  3. 3. The Importance of Good Requirements<br />
  4. 4. Why We Need Requirements<br />If you do not know where you are going….you will wind up somewhere else!!<br />Yogi Berra<br />Most of us have learned this lesson and it is why we value requirements as a critical part of systems and software development<br />4<br />
  5. 5. 5<br /> Requirements Definition and Management Business RealitiesTraditional methods yield excess rework, delays & poor quality<br /><ul><li>Lost Opportunity
  6. 6. Late to marketby6 months or more will cost organizations 33% of the 5-year ROI
  7. 7. 41% of projects fail to deliver expected business ROI
  8. 8. 49% of projects overrun original estimates
  9. 9. -Standish Group</li></ul>Cost<br /><ul><li>70-80% of development costs are spent identifying and correcting defects
  10. 10. More than 40% of development budget will be consumed by poor requirements</li></ul>200<br />50<br />20<br />Relative Cost to Repair<br />10<br />5<br />1-2<br />0<br />Acceptance<br />QA Test<br />Coding<br />Design<br />Analysis<br />Maintenance<br />
  11. 11. 6<br /> The purpose of requirements and requirement management<br />Requirements and Requirement management need to do two things:<br />1) Validate - Make sure you are building the right product: <br />Are we doing the right thing?<br />2) Verify - Make sure you built the product right:<br />Are we doing the thing right?<br />
  12. 12. 7<br /> What can happen when Requirements are not done right:<br />
  13. 13. The Challenges of Developing Good Requirements<br />
  14. 14. 9<br />Executive<br />Quality Manager<br />We are continuously pushed to increase quality with less resources!<br />Development and Test teams<br />Poor Requirements Practices Pose Significant Challenges Across Teams<br />We can’t keep up with requirement changes and know what is most important to develop and test<br />We struggle with budgets and can’t consistently meet customer needs<br />Reduce Cost<br />Efficiency+Innovation<br />Improve Quality<br />Accelerate Delivery Time<br />Analyst<br />It’s hard to accurately capture requirements & make sure they are implemented & tested<br />
  15. 15. 10<br />Safety<br />Regulatory compliance<br />Development timescales<br />Project scale<br />Project life<br />…<br />Different industries have different needs…<br />Cost<br />Quality<br />Time<br />
  16. 16. 11<br /> Engineers like to solve problems<br /> Measure twice, cut once Look before you leap<br />Thinking before you act saves time, money, effort and improves quality. It’s plain common sense, yet, when it comes to requirements management, this common sense seems not to be there. Many projects start before thought has been put into the project’s purpose, its desired results, and how its success will ultimately be measured.<br />
  17. 17. 12<br /> Working with Requirements is a lifecycle activity<br />You need to enable requirements to evolve during the lifecycle<br />Increase the likelihood of delivering value early<br />Minimizes risk<br />Minimizes re-work<br />Reduces confusion<br />Improves quality<br />
  18. 18. Requirements are always changing <br /><ul><li>Changes in environment (e.g. new threats) lead to changes in stakeholder needs
  19. 19. Changes in technology (e.g. cheaper memory) lead to new stakeholder requirements and possible solutions that are cheaper, faster, etc.
  20. 20. Changes in stakeholders (e.g. new customer in charge) lead new views and new stakeholder requirements
  21. 21. Changes in budget ( e.g. funding cut) funding lost
  22. 22. And the longer your development timescale the greater the chance that requirements will change during your project</li></ul>13<br />
  23. 23. 14<br /> Requirements come from everywhere<br />Goal<br />Feature<br />Function<br />Rule<br />Regulation<br />Risk<br />Objective<br />Need<br />Aim<br />Criterion<br />Requirements<br />
  24. 24. 15<br /> People over design<br />Programs are getting so complex put solutions do not always need to be complicated. The simplest solution is usually the best. John Deere fuel tank sight gauge is a great example of this<br />
  25. 25. 16<br /> There are many different types of requirements<br />Stakeholder Requirements <br />Architectural Requirements<br />Structural Requirements<br />Behavioral Requirements<br />SystemsFunctional Requirements<br />Non-functional Requirements<br />Performance Requirements<br />Design Requirements<br />Derived Requirements<br />Allocated Requirements<br />……….<br />
  26. 26. 17<br />Factors which complicate Requirements Management<br />Multiple requirement sets<br />Large number of requirements<br />Different levels of requirements<br />Version control<br />Change control<br />Product lines <br />Distributed teams<br />Different processes<br />Impact of changes<br />Systems of systems<br />Convergence of old and new technologies<br />
  27. 27. Writing Requirements<br />
  28. 28. 19<br /> Requirement Writing<br /><ul><li>The art of writing requirements takes great skill and, like writing code, the end result is usually cleaner and more consistent if there’s a single author.
  29. 29. Don’t expect to get the requirements 100% correct. You need to allow for human nature and use the same language as your client.
  30. 30. The following guideline gives 13 tips on how to write better requirements by following simple rules for word selection and sentence structure.
  31. 31. Most of these guidelines only apply to the requirement statements, not the complete specification.</li></li></ul><li>20<br /> Requirement Writing<br />1: Use the simplest words appropriate to state a complete requirement.<br />An eloquently written requirement is probably not a good one. <br />A requirement must be written so many different people can understand it.<br />
  32. 32. 21<br /> Requirement Writing<br />2: Use requirement imperatives correctly.<br /> Use company/program defined list.<br /> If requirements are from a non-company source, make sure you know the meaning of these words. (Definitions should be included in Section 1 of the specification)<br />Common imperative definitions;<br />“Shall” Definition <br />“Shall” denotes a mandatory and contractual requirement. “Shall” requires metrics to quantify and requires a verification process.<br />“Will” Definition <br />“Will” denotes a mandatory and contractual requirement. It is similar to “shall” but does not require metrics or verification.<br />“Should” Definition<br />“Should” denote a design goal, an objective the system tries to meet.<br />
  33. 33. 22<br /> Requirement Writing<br />3: Do not use weak phrases and subjective words.<br />Following are words and phases not to use when writing a requirement:<br />Adequate<br />As Appropriate<br />Bad<br />Better<br />But not limited to<br />Correct<br />Easy<br />Effective<br />Ideal<br />Large<br />Maximize<br />Minimize<br />Most<br />Must<br />Necessary<br />Normal<br />Quick<br />Rapid<br />Readily<br />Relevant<br />Satisfactory<br />Shall not<br />Small<br />Sufficient<br />Suitable<br />Timely<br />Typical<br />User friendly<br />Was<br />
  34. 34. 23<br /> Requirement Writing<br />4: Use continuations carefully, they make traceability and verification difficult. Use when all items are to be verified by the same method at the same time.<br />Example:<br />The system shall report software status to the host interface under the following conditions:<br /> At system initialization.<br /> When the status of an external interface has changed.<br /> When a report has been requested.<br />5:Use examples, tables, figures etc., they are a great source of information and clarification.<br />Make sure examples and notes are clearly marked as such (not part of requirement). <br />For tables; specify if all, some or none of the cells are requirements. <br />Clearly indicate if a figure or part of the figure, is part of the requirement, or is information.<br />
  35. 35. 24<br /> Requirement Writing<br />6: Be consistent with names; always call the same entity by the same name.<br />Example: If in some requirements the subject is called “the System,” and in others “ the URQ-65”, the names are not consistent.<br />Always use the correct name for the level of specification. You can not verify a sub capability at a systems level.<br />7: If you use a TBD or TBR, have a plan. You must state who is responsible for the information, and when the it will be completed.<br />
  36. 36. 25<br /> Requirement Writing<br />8: Make sure a requirement contains all the qualities of a good requirements<br />Concise: Minimal, easily understood, a complete expression of a single thought, non-ambiguous; only one possible interpretation.<br />Correct: An absence of errors of fact.<br />Consistent: No conflicts between individual requirements, parts of a single requirement complement each other. Connectivity exists between the requirements; consistent words and terms<br />Traceable: Know source of requirement and be able to allocate it, Uniquely identified for life. Never re-used identification on Project.<br />Verifiable: Method (Test, Inspection, Demonstration, Analysis, Certification) Understand how requirement can be verified, and determine criteria for acceptance.<br />Necessary:Can the system be complete without this requirement?<br />Attainable: Is this requirement technically feasible within given time and cost?<br />Modular:Will a change to this requirement have a big impact on the system? Can this requirement be easily used and monitored by other programs if needed?<br />Restrictive– The requirement should written in such a way as to not limit implementation. Make sure the requirement states what needs to be done not how.<br />
  37. 37. 26<br /> Requirement Writing<br />9: Conjunctions. There should be only one requirement per statement.<br />A requirement should not contain “and” or “or”. <br />Requirement which contain “and”, “or” or “and/or” probably contain more than one requirements. These hard to trace and completely verify.<br />10: Make sure that if a requirement references another document, that it does so correctly.<br />State if reference is information or part of the requirement.<br />Make sure references are listed in applicable document section and state what part of reference applies<br />
  38. 38. 27<br /> Requirement Writing<br />11: Make sure Acronyms are used correctly.<br /> Place the acronym in the acronym list in the specification. <br /> Spell out the complete phrase followed by the acronym in parenthesis the first time used.<br />The next time just use the acronym.<br />Example: first use: “The SATCOM Antenna Interface Unit (SAIU) shall…”, second use “The SAIU shall…”<br />12: Overspecification leads to unfunded requirements, and can add duplicate requirements. <br />The length of a requirement should not be excessive.<br />
  39. 39. 28<br /> Requirement Writing<br />13: Use the requirement template<br />There are four major parts to a requirement:<br />Entities – <br />Subject of the requirements (noun)<br />Object of action (noun)<br />Actions – What the subject does, contains imperative (verb)<br />Conditions – What must be in place in order for this action to take place <br />Constraints– Qualifies the action, performance<br />The following is the structure of a basic requirement:<br />[Conditions] [Subject] [Action] [Object] [Constraint]<br />Example:<br />When signal x is received [Conditions] ,the system [Subject]shall set [Action]the signal x received bit [Object]within 2 seconds [Constraint].<br />
  40. 40. Requirements Elicitation<br />
  41. 41. 30<br /> Requirement Elicitation<br />The development process starts with understanding the client’s “business requirements”.<br />For the success of any project, an agreed upon understanding of the desired capability is extremely critical.<br />Requirements elicitation is the process of identifying the sources of requirements for a new project and obtaining those requirements from those sources.<br />The most important outcome is that the people who need to understand the requirements can do so. <br />
  42. 42. 31<br /> Requirement Elicitation<br />There are many ways in which requirements can be gathered, there are several requirements elicitation techniques available to use<br />You should gather requirements using whichever method works for you. Whether you prefer a written document, screen diagrams, prototyping or use cases<br />Keep in mind that your choice of techniques will depend on your comfort level or familiarity, the complexity or nature of your project as well as the stakeholders you are talking to.<br />Each requirements elicitation technique has its advantages and disadvantages and that there is no one technique that works for every situation.<br />The following are some popular and recommended techniques for requirements elicitation:<br />
  43. 43. 32<br /> Requirement Elicitation<br />1. Interviews: This technique uses a series of questions to extract information from the stakeholder, that focus on the client’s perspective, develops an understanding of the problem and finally evaluates the effectiveness of the meeting. <br />2. Document Review: All effective requirements elicitation involves some level of document analysis such as business plans, markets studies, contracts, requests for proposals, statements of work, existing guidelines, analyses of existing systems, and procedures. Improved requirements coverage results from identifying and consulting all likely sources of requirements. <br />
  44. 44. 33<br /> Requirement Elicitation<br />3. Brainstorming: Brainstorming is a powerful technique because the most creative or effective ideas often result from combining seemingly unrelated ideas. Also, this technique encourages original thinking and the proposal of unusual ideas. Brainstorming involves both idea generation and idea reduction. The goal of the former is to identify as many ideas as possible, while the latter ranks the ideas into those considered most useful by the group.<br />4. Use Cases: A use case is a picture of actions that a system performs by depicting the actions. This should be accompanied by a textual description and should not be used in isolation from other requirements gathering techniques. Use cases and scenarios are known for facilitating team communication. They provide a context for the requirements by expressing the sequence of events and a common language for the end users and the technical team.<br />
  45. 45. 34<br /> Requirement Elicitation<br />5. Requirements Workshops: This technique is considered very powerful for eliciting requirements because they can be designed to encourage consensus concerning the requirements of a particular capability. Other advantages that are achieved by this technique includes commitment of participants to the work products and project success, teamwork, resolution of political issues and reaching consensus on a host of topics. <br />6. Prototyping: This technique helps in building a quick and rough version of the desired system or parts of the system. This illustrates the capabilities of the system to users and designers. This technique serves as an excellent means of communication mechanism for all reviewers in understanding the interactions with the system. This sometimes gives an overly optimistic impression of completion possibilities since an impression is created that the developers are further along than is actually the case. Prototypes can be combined very effectively with other approaches such as JAD and models. <br />
  46. 46. 35<br /> Requirement Elicitation<br />7. Storyboards: This technique is a set of drawings depicting a set of user activities that occur in an existing or envisioned system or capability. Storyboards may be thought of as forms of paper prototyping. In this technique, the Customers, Users or developers start by drawing pictures of the screens, dialogs, toolbars and other elements they believe the software should provide. These drawings are evolved by the group till the real requirements and details are worked out and agreed upon. This technique is in expensive and eliminates the risks and higher costs of prototyping. <br />8 Interfaces Analysis: One of the major causes of overrun is missing or incorrect interface. Identifying the external interfaces early clarifies product scope, aids risk assessment, reduces product development costs, and improves customer satisfaction. The steps of identifying, simplifying, controlling and monitoring interfaces help to reduce the risk of problems related to interfaces. <br />
  47. 47. 36<br /> Requirement Elicitation<br />9. Glossary: to use the same language as your client. If the language is consistent, it greatly lowers the risk of misinterpretation of the requirements. Problems can develop if we didn’t use the same terms as the client. To avoid this problem is to include a glossary of terms and definitions in the requirements document.<br />10. Modeling: A model is a representation of reality or level of abstraction that is intended to facilitate understanding. They help eliminate ambiguities and inconsistencies and are correlated with the most successful projects. <br />
  48. 48. 37<br /> Requirement Elicitation<br />11. Separate the problem and solution space: It is important to keep requirement elicitation implementation free. You should be working on understanding the problem, not solving it. Not keeping the requirements elicitation design free can create unnecessary restrictions and your product<br />
  49. 49. 38<br /> Requirement Elicitation<br />12. Validating Requirements: One of the key activities to determine you have the right set of requirements is the requirement Validation: Before we accept requirements from Systems or a customer, we need to review the requirement set to see the quality of the requirements. This would let us know what is missing and what work needs to be done to the requirements. Can now develop a plan to address requirement needs.<br />
  50. 50. Using Requirement Management Tools<br />
  51. 51. The benefits of good requirements engineering tools...<br /><ul><li>Query attributes to find specific properties
  52. 52. “How many requirements are listed as high risk?”
  53. 53. Use traceability reports for checking dependencies
  54. 54. Before change is committed
  55. 55. Find “missing” links
  56. 56. “Which detailed requirements has no relation to a high-level user requirement?”
  57. 57. Coverage analysis
  58. 58. “Which higher level requirement has no lower-level requirement?”
  59. 59. Impact analysis
  60. 60. “What lower level requirements are affected if a high level requirement changes?”
  61. 61. Keep traceability
  62. 62. For each increment, if you develop incrementally with concurrent phases
  63. 63. For each variant, if you manage variants and product lines </li></ul>40<br />
  64. 64. 41<br /> Rational Requirements Definition and Management SolutionEnabling business & technology experts to build business value<br />Business Processes<br />Business Objectives<br /><ul><li>Achieve stakeholder consensus early and often in the development lifecycle to reduce rework and improve time to market
  65. 65. Improve collaboration among distributed teams to increase productivity and quality
  66. 66. Insure alignment of business and IT through linking and traceability of requirements artifacts to increase reuse and ensure effective software delivery</li></ul>Use Cases<br />Sketches<br />Requirements Definition<br />Rational Requirements Composer<br />Elicit, capture, elaborate, review and discuss requirements using a variety of techniques and notations<br />Rich text Documents<br />Prototypes<br />Visual Validation<br />Storyboards <br />Requirements Management<br />Rational DOORS & Rational RequisitePro<br />Understand the impact of change as it occurs <br />and ensure full traceability to <br />better manage project risk<br />Search, filter on attributes<br />Impact & Coverage analysis<br />Traceability between related artifacts<br />41<br />
  67. 67. 42<br /> More information<br />Requirement management and definition webpage:<br />Rational RM Solutions<br />
  68. 68. 43<br /> Rational Publishing Engine: Document automation across the development lifecycle<br /><ul><li>Quickly and accurately create the right document for your development domain at the required time
  69. 69. Access data from a wide range of Rational tools, including:
  70. 70. DOORS
  71. 71. ClearCase/ClearQuest
  72. 72. Focal Point
  73. 73. System Architect
  74. 74. Rational Quality Manager
  75. 75. RequisitePro
  76. 76. Rhapsody
  77. 77. Rational Requirements Composer
  78. 78. Team Concert
  79. 79. Test Manager
  80. 80. Access data from third party tools via XML and REST interfaces
  81. 81. Out-of-the-box document templates provided for quick ROI</li></li></ul><li>44<br /> RPE – Can create a document from multiple sources.This document extracts data from DOORS, ClearQuest and Rhapsody<br />
  82. 82. 45<br />Smarter healthcare<br />Smarter automobiles<br />Smarter electronic devices<br />Smarter hybrid technologies<br />Smarter defense systems<br />Smarter energy<br />Smarter Requirements Build Smarter Products<br />Innovation for a smarter planet<br />45<br />
  83. 83. 46<br />
  84. 84. 47<br />Systems and Software Engineering Symposiums<br />
  85. 85. 48<br />Upcoming symposiums<br />Landing page for all Symposiums: http://www.ibm.com/events/systemsengineeringsymposium<br />
  86. 86. 49<br />Upcoming symposium<br />DC Flyer<br />
  87. 87. 50<br /><ul><li>Learn more at:
  88. 88. IBM Rational software
  89. 89. IBM Rational Software Delivery Platform
  90. 90. Process and portfolio management
  91. 91. Change and release management
  92. 92. Quality management
  93. 93. Architecture management
  94. 94. Rational trial downloads
  95. 95. Leading Innovation Web site
  96. 96. developerWorks Rational
  97. 97. IBM Rational TV
  98. 98. IBM Business Partners
  99. 99. IBM Rational Case Studies</li></ul>© Copyright IBM Corporation 2008. All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, Rational, the Rational logo, and other IBM products and services are trademarks of the International Business Machines Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others.<br />