SpecFlow Living Documentation VSTS Extension

SpecFlow is the defacto BDD tool for .NET programmers – and if you are using both SpecFlow and Visual Studio Team Services then this article is for you.

There is a new VSTS extension called SpecFlow+LivingDoc that provides a simple build task that will generate documentation from your feature files.

Here is a quick run-down of the steps to use the extension…

  1. Get a trial license key from SpecFlow to try this out, or buy a license
  2. Add the SpecFlow+LivingDoc VSTS Extension
  3. Go to a build that has feature files and add the “Utilities -> SpecFlow+ build step”. Choose the project file that contains feature files.
  4. Run the build

When the build is complete, the searchable feature files are made available in the “Test” link in the main menu, so head to “Test -> SpecFlow+” to see the results.

Note! The first time you open up this screen and choose a feature, you’ll see a prompt to add a license key. Look for the text “evaluation” in the top right corner and click it to enter the license details.

The features listed can be explored, or searched – and are displayed colour-coded to aid readability.

This is a great way to make your features business-visible.