{"id":26042,"date":"2018-02-06T08:36:41","date_gmt":"2018-02-06T16:36:41","guid":{"rendered":"https:\/\/www.jamasoftware.com\/?p=26042"},"modified":"2023-01-12T16:53:18","modified_gmt":"2023-01-13T00:53:18","slug":"striking-right-level-detail-requirements","status":"publish","type":"post","link":"https:\/\/www.jamasoftware.com\/legacy\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/","title":{"rendered":"Striking the Right Level of Detail in Requirements"},"content":{"rendered":"

\"\"<\/p>\n

In today\u2019s hyper-competitive marketplace, companies are releasing products faster than ever before. However, that increased emphasis on time to market doesn\u2019t change the expectations: producing quality products while, when necessary, conforming to all relevant safety and quality standards<\/a>.<\/p>\n

Finding that critical balance between speed and quality is essential for product teams, which is where requirements management<\/a> comes into play. Unfortunately, a lot of teams don\u2019t take the time to flesh out requirement details \u2013 or they have the opposite problem and provide too many details, and confuse requirements with design specifications. Here are some examples and recommendations to make sure you’re getting the most value from your requirements.<\/p>\n

Scenario 1: I need more details!<\/strong><\/p>\n

In this situation, teams fall into a trap of not taking the time to define requirements. For example, a marketing team \u2014 which tend to think more strategically \u2014 will often give high-level problem statements directly to an engineering team, which typically thrive on details.<\/p>\n

What happens next is either:<\/p>\n

    \n
  1. \n
      \n
    1. Engineering team builds a product that doesn\u2019t solve the high-level problem<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      or<\/p>\n

        \n
      1. Engineering team will bombard the marketing team with requests for additional information until both sides are frustrated and late on delivery<\/li>\n<\/ol>\n

        Neither scenario results in a smooth development process, and both can breed mistrust between teams whose ultimate goal is the same, in spite of their differing roles.<\/p>\n

        Well-formed and reviewed requirements clear the path for a quality product that meets market needs and expectations.<\/p>\n

        They ensure each team member is on the same page, and that everyone involved knows exactly what they\u2019re building and why.<\/p>\n

        Scenario 2: Too many details \u2013 I can\u2019t innovate!<\/strong><\/p>\n

        In this case, the team members responsible for authoring requirements can sometimes cram too many design details into the requirements themselves. For example, I once saw a requirement that read: \u201cthe button shall be red and shall be located in the top-right corner of the console.\u201d<\/p>\n

        First off, that\u2019s actually two requirement statements \u2013 but either way \u2013 it\u2019s describing implementation detail and, taken on it\u2019s own, I have no idea of \u201cwhat\u201d the button should do or \u201cwhy.\u201d Is this supposed to dispense a soda from a vending machine or fire a missile from a battleship?!?<\/p>\n

        Requirements like these create friction within engineering teams, limiting their ability to innovate while getting bogged down with overly specific instructions.<\/p>\n

        Engineering teams should ideally be free to iterate and innovate the design rather than simply doing what they\u2019re told. The requirements should focus on the need and keep teams aligned on \u201cwhat\u201d is needed and \u201cwhy\u201d while engineering experts figure out \u201chow\u201d to implement.<\/p>\n

        Recommendation: Establish a Common Taxonomy and Trace Model<\/strong><\/p>\n

        An important step in striking the right level of detail in your requirements is establishing common terms in your product development process.<\/p>\n

        Many teams use different terms to refer to the same thing (e.g. \u201cspecification\u201d \u2013 this term means so many different things across different teams).<\/p>\n

        Having a glossary or standard that clearly delineates important terms and deliverables facilitates clarity throughout the development process and reduces the confusion referenced above.<\/p>\n

        Using a traceability model<\/a> establishes appropriate hierarchy and helps break down high-level problems to detailed requirement needs. It also can facilitate test coverage of requirements. This clarity is especially important when dealing with life-critical systems, such as medical devices or autonomous vehicle systems. In these cases, missing requirements or inadequate design and testing can quite literally cost\u00a0 lives.<\/p>\n

        Finally, teams should be able to differentiate Requirements from Design. In other words, the \u201cNeed\u201d vs the \u201cHow.\u201d Bundling both together inside requirements can lead to added complexity, unnecessarily constrained design, and friction between teams.<\/p>\n

        Quickly bringing a quality, safe product to market is a challenge. Requirements and design are both key elements to doing so. Making sure teams strike the right level of detail in the requirements is critical in avoiding confusion and reducing friction in the process.<\/p>\n

        For a deeper dive on separating requirements and design specifications, check our this webinar, \u201c<\/em>Best Practices for Writing Requirements<\/em><\/a>.\u201d Jama also offers Requirements 101 workshops \u2013 please inquire<\/a> if you\u2019re interested in improving the requirements process in your organization!<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

        Finding that critical balance between speed and quality is essential for product teams, which is where requirements management comes into play.<\/p>\n","protected":false},"author":99,"featured_media":54468,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[50],"tags":[51,128],"industry":[],"class_list":["post-26042","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-requirements-management","tag-business-requirements","tag-requirements-management"],"acf":[],"yoast_head":"\nFiguring Out the Right Level of Detail in Requirements | Jama Software<\/title>\n<meta name=\"description\" content=\"Finding critical balance between speed and quality is essential for product teams, which is where detail in requirements management come into play.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Striking the Right Level of Detail in Requirements\" \/>\n<meta property=\"og:description\" content=\"Finding that critical balance between speed and quality is essential for product teams, which is where requirements management comes into play.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/\" \/>\n<meta property=\"og:site_name\" content=\"Jama Software\" \/>\n<meta property=\"article:published_time\" content=\"2018-02-06T16:36:41+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-01-13T00:53:18+00:00\" \/>\n<meta name=\"author\" content=\"Preston Mitchell\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"Striking the Right Level of Detail in Requirements\" \/>\n<meta name=\"twitter:description\" content=\"Finding that critical balance between speed and quality is essential for product teams, which is where requirements management comes into play.\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/static.jamasoftware.com\/www\/imports\/2018\/02\/Social-Blog-Share_-New-Test-Runner-App-1.png\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Preston Mitchell\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/\"},\"author\":{\"name\":\"Preston Mitchell\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/#\\\/schema\\\/person\\\/d0efd0d10f8b01a5adf5de4be02924fd\"},\"headline\":\"Striking the Right Level of Detail in Requirements\",\"datePublished\":\"2018-02-06T16:36:41+00:00\",\"dateModified\":\"2023-01-13T00:53:18+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/\"},\"wordCount\":697,\"image\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.jamasoftware.com\\\/media\\\/2018\\\/02\\\/Header-Image_-Blog-Post-25.png\",\"keywords\":[\"business requirements\",\"requirements management\"],\"articleSection\":[\"Requirements & Requirements Management\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/\",\"url\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/\",\"name\":\"Figuring Out the Right Level of Detail in Requirements | Jama Software\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.jamasoftware.com\\\/media\\\/2018\\\/02\\\/Header-Image_-Blog-Post-25.png\",\"datePublished\":\"2018-02-06T16:36:41+00:00\",\"dateModified\":\"2023-01-13T00:53:18+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/#\\\/schema\\\/person\\\/d0efd0d10f8b01a5adf5de4be02924fd\"},\"description\":\"Finding critical balance between speed and quality is essential for product teams, which is where detail in requirements management come into play.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.jamasoftware.com\\\/media\\\/2018\\\/02\\\/Header-Image_-Blog-Post-25.png\",\"contentUrl\":\"https:\\\/\\\/www.jamasoftware.com\\\/media\\\/2018\\\/02\\\/Header-Image_-Blog-Post-25.png\",\"width\":856,\"height\":573},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/2018\\\/02\\\/06\\\/striking-right-level-detail-requirements\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.jamasoftware.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Striking the Right Level of Detail in Requirements\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/#website\",\"url\":\"https:\\\/\\\/www.jamasoftware.com\\\/\",\"name\":\"Jama Software\",\"description\":\"Jama Connect\u00ae #1 in Requirements Management\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.jamasoftware.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.jamasoftware.com\\\/#\\\/schema\\\/person\\\/d0efd0d10f8b01a5adf5de4be02924fd\",\"name\":\"Preston Mitchell\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g\",\"caption\":\"Preston Mitchell\"},\"description\":\"Mr. Mitchell's experience is focused in complex product development for Fortune 500 companies and the U.S. federal government. Jama Software works with inspiring and innovative companies building next generation products like self-driving cars, life saving medical devices, and safety critical avionics. Preston is a subject matter expert in product management and requirements management best practices with focused experience in avionics, medical devices, and complex software. He's experienced leading clients through the full lifecycle of a technology program. Preston's current responsibilities at Jama Software include directing our Global Consulting team with focus on scaling our delivery quality and efficiency as Jama Software grows. Specialties: System Engineering, Requirements Management, Test Management, Scaled Agile\",\"url\":\"https:\\\/\\\/www.jamasoftware.com\\\/blog\\\/author\\\/pmitchell\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Figuring Out the Right Level of Detail in Requirements | Jama Software","description":"Finding critical balance between speed and quality is essential for product teams, which is where detail in requirements management come into play.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/","og_locale":"en_US","og_type":"article","og_title":"Striking the Right Level of Detail in Requirements","og_description":"Finding that critical balance between speed and quality is essential for product teams, which is where requirements management comes into play.","og_url":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/","og_site_name":"Jama Software","article_published_time":"2018-02-06T16:36:41+00:00","article_modified_time":"2023-01-13T00:53:18+00:00","author":"Preston Mitchell","twitter_card":"summary_large_image","twitter_title":"Striking the Right Level of Detail in Requirements","twitter_description":"Finding that critical balance between speed and quality is essential for product teams, which is where requirements management comes into play.","twitter_image":"https:\/\/static.jamasoftware.com\/www\/imports\/2018\/02\/Social-Blog-Share_-New-Test-Runner-App-1.png","twitter_misc":{"Written by":"Preston Mitchell","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#article","isPartOf":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/"},"author":{"name":"Preston Mitchell","@id":"https:\/\/www.jamasoftware.com\/#\/schema\/person\/d0efd0d10f8b01a5adf5de4be02924fd"},"headline":"Striking the Right Level of Detail in Requirements","datePublished":"2018-02-06T16:36:41+00:00","dateModified":"2023-01-13T00:53:18+00:00","mainEntityOfPage":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/"},"wordCount":697,"image":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#primaryimage"},"thumbnailUrl":"https:\/\/www.jamasoftware.com\/media\/2018\/02\/Header-Image_-Blog-Post-25.png","keywords":["business requirements","requirements management"],"articleSection":["Requirements & Requirements Management"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/","url":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/","name":"Figuring Out the Right Level of Detail in Requirements | Jama Software","isPartOf":{"@id":"https:\/\/www.jamasoftware.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#primaryimage"},"image":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#primaryimage"},"thumbnailUrl":"https:\/\/www.jamasoftware.com\/media\/2018\/02\/Header-Image_-Blog-Post-25.png","datePublished":"2018-02-06T16:36:41+00:00","dateModified":"2023-01-13T00:53:18+00:00","author":{"@id":"https:\/\/www.jamasoftware.com\/#\/schema\/person\/d0efd0d10f8b01a5adf5de4be02924fd"},"description":"Finding critical balance between speed and quality is essential for product teams, which is where detail in requirements management come into play.","breadcrumb":{"@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#primaryimage","url":"https:\/\/www.jamasoftware.com\/media\/2018\/02\/Header-Image_-Blog-Post-25.png","contentUrl":"https:\/\/www.jamasoftware.com\/media\/2018\/02\/Header-Image_-Blog-Post-25.png","width":856,"height":573},{"@type":"BreadcrumbList","@id":"https:\/\/www.jamasoftware.com\/blog\/2018\/02\/06\/striking-right-level-detail-requirements\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.jamasoftware.com\/"},{"@type":"ListItem","position":2,"name":"Striking the Right Level of Detail in Requirements"}]},{"@type":"WebSite","@id":"https:\/\/www.jamasoftware.com\/#website","url":"https:\/\/www.jamasoftware.com\/","name":"Jama Software","description":"Jama Connect\u00ae #1 in Requirements Management","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.jamasoftware.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.jamasoftware.com\/#\/schema\/person\/d0efd0d10f8b01a5adf5de4be02924fd","name":"Preston Mitchell","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/767ba0aadab8835de0577c12a3e6f6c5b9dc638862ebc388d7e1a365fd25f978?s=96&d=mm&r=g","caption":"Preston Mitchell"},"description":"Mr. Mitchell's experience is focused in complex product development for Fortune 500 companies and the U.S. federal government. Jama Software works with inspiring and innovative companies building next generation products like self-driving cars, life saving medical devices, and safety critical avionics. Preston is a subject matter expert in product management and requirements management best practices with focused experience in avionics, medical devices, and complex software. He's experienced leading clients through the full lifecycle of a technology program. Preston's current responsibilities at Jama Software include directing our Global Consulting team with focus on scaling our delivery quality and efficiency as Jama Software grows. Specialties: System Engineering, Requirements Management, Test Management, Scaled Agile","url":"https:\/\/www.jamasoftware.com\/blog\/author\/pmitchell\/"}]}},"_links":{"self":[{"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/posts\/26042","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/users\/99"}],"replies":[{"embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/comments?post=26042"}],"version-history":[{"count":0,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/posts\/26042\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/media\/54468"}],"wp:attachment":[{"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/media?parent=26042"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/categories?post=26042"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/tags?post=26042"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/www.jamasoftware.com\/legacy\/wp-json\/wp\/v2\/industry?post=26042"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}