Your Privacy

This site uses cookies to enhance your browsing experience and deliver personalized content. By continuing to use this site, you consent to our use of cookies.
COOKIE POLICY

Skip to main content

The Requirements Pickle | How Gherkin Can Get You Out of a Jam

The Requirements Pickle | How Gherkin Can Get You Out of a Jam
Back to insights

UDig’s Client Services team has partnered with our Engineering team to revamp the way we conduct client requirements gathering. This partnership has allowed for an increased universal understanding of a client’s wants and needs through intuitive user story development, consistent stakeholder engagement and workflow-centric design. While the benefits of such a practice are apparent for project management and development, our team discovered a few hidden benefits of this practice as it matured.

Requirements gathering is certainly not a new concept. Engaging with clients early and often from the inception of a project builds trust, prevents rework and provides direction for the team. In an Agile environment, development teams need requirements early to start design quickly. As a Project Manager, it is critically important to solicit accurate requirements in a format that makes sense to the client, designers, developers, engagement managers and beyond.

The cornerstone of this process has been the user story. User stories capture what a system user needs to do in a format that any stakeholder throughout the agile cycle can understand. UDig has long employed this methodology to translate functionality into business language but has recently employed a new all-inclusive strategy.

Enter the Gherkin format for user stories. The plain language parser, Gherkin, was created for the Cucumber software tool to conduct acceptance testing in a behavior-driven development (BDD) method. The core concept of BDD is that software development must be managed by interests both technical and business. This balancing act makes the Gherkin format perfect for structuring user stories. Gherkin is written using the following structure:

[Scenario]

GIVEN some context
WHEN some action is carried out
THEN a particular set of observable consequences should occur

Here is an example of how gherkin can be used to document the feature of adding a new item to an online shopping cart:

Scenario: User adds an item to a cart

GIVEN I am a logged in user
WHEN I go to the item page
AND I click “add item to cart”
THEN the quantity of items in my cart should go up
AND my subtotal should increment

Any scenario can benefit from this methodology as it provides a logical structure that developers can easily understand, project managers can easily track and clients can easily verify and tweak.

Digging In

  • Strategy & Planning

    The Service Blueprint: A Smarter Approach to Modernization

    Modernization isn’t just about upgrading technology—it’s about upgrading your organization’s ability to change and adapt.

  • Strategy & Planning

    Energy 2025 – Expansion of Fossil Fuels or Carbon Reduction?

    Now that the election is behind us, we have an opportunity to anticipate the possible effects on the energy industry under this new administration. What strategies will be impacted? What will remain the same? What opportunities can we take advantage of in 2025? This video is meant to dig into these questions and provide some […]

  • Strategy & Planning

    A Smarter Approach to Modernization: Aligning Business and Technology with the Service Blueprint

    In today’s rapidly evolving world, businesses are under constant pressure to adapt and thrive in an environment where change is the only constant. Technology, the backbone of modern operations, must evolve at the pace of these shifting demands, yet legacy applications often hinder progress. As businesses try to move faster, outdated systems can’t keep up—leading […]

  • Strategy & Planning

    7 Trends to Watch in 2025: Leveraging Technology to Achieve Business Objectives

    As we head into 2025, it’s clear that technology isn’t just a part of business strategy — it’s a powerful enabler of success. At UDig, we see it every day: organizations leveraging new tools, technologies and approaches to achieve their goals faster, smarter, and with greater impact. Whether it’s using AI to streamline multiple processes, […]

  • Strategy & Planning

    Optimizing IT Workflows for Enhanced Efficiency and Productivity

    In the digital age, where efficiency dictates success, precise workflow management is essential for IT teams striving to meet their goals and deliver exceptional services. UDig recently had the opportunity to collaborate with a client to enhance one of their business systems support team’s workflow management processes. This post highlights the transformation achieved through our […]

  • Strategy & Planning

    Bridging the Gap Between an Idea and Its Impact

    Transforming a vision or idea into a tangible outcome that creates real value is a common challenge that many individuals and organizations face. Often, ideas remain abstract concepts without a clear path to realizing them and generating measurable impact. This gap between having an idea and understanding how to effectively execute and achieve the desired […]