bdduser-storiesatdd

how to summarise and navigate BDD stories when you have so many?


I have many BDD stories/scenarios (450+ and rising) that I have inherited for an existing system: more info. The stories are organised using file system folders:

C:\specifications
   |
   + myproject
     |
     |- admin stories
     |  |- account_management.story
     |  +- finance_management.story
     |
     +- customer stories
        |- pay_bils.story 
        +- update_details.story

There are so many stories, that trying to understand the functionality from reading the story text files is like trying to understand a system's technical architecture from reading thousands of lines of source code.

I've tried using unix commands to summarise the stories, but this still doesn't help me to navigate the stories. For example, the following command prints out the story file name and the narrative even if the narrative spans multiple lines:

find . -name *.story -exec ls "{}" \; -exec sed -n '/^Narrative/,/^$/p' {} \;

Produces output similar to:

...

./stories/basket/basket.story
Narrative:
In order to buy goods
As a customer
I want to add items to my basket

...

This question is similar to this one, but there are some key differences:


Solution

  • I used this project to export my stories to gherkin format, and then processed them using this project to create some really nice html output.