Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Depending on your preferences menu options the Feature panel might be loaded in Gherkin Text Editor mode rather than Example Mapping, so you will see textual representation rather like below.

...

Info

Search for issues with Features

Query below can be used to find all Jira issues where the Feature panel has at least some text

Feature.content IS NOT EMPTY

image-20241014-191106.pngImage Added

Search for Feature Attributes

The following list of attributes becomes are searchable with JQL:

Feature.userStories

...

Description: how many User Stories the Feature contains. A User Story in this case means that there are 3 common keywords: ‘As a', ‘I want to’ and ‘So that’ after the Feature keyword and there is some text after each of these keywords. 'In order to’ keyword can be used instead of ‘So that’.

Expand
titleExamples

...

Feature.userStories = 0

Could be used to identify Jira issues that have some Feature text but are missing

...

key pieces of information such as who the user or the stakeholder is for whom the story is valuable and/or why exactly

...

the story is needed, or in other words ‘As I' or 'So that’ keywords are missing.

image-20241013-122609.pngImage Added

Feature.userStories > 1

Could be used to identify Features that contain more than one User Story and therefore should be split into further Jira issues.

image-20241013-122849.pngImage Added

Feature.questions

Type - Number

Description: total number of questions the Feature contains. Questions are comment lines prefixed with “Q:“ keyword, see more in Questions & Answers.

Expand
titleExamples

Feature.questions = 0

Could be used to identify Jira issues that are potentially completely clear to the development team and therefore ready to go into the Sprint Backlog or maybe those which have not been discussed yet at all.

image-20241013-123527.pngImage Added

Feature.unansweredQuestions

Type - Number

Description: total number of unanswered questions, i.e. those that do not have the 'A:' keyword on line below, see more in Questions & Answers.

Expand
titleExamples

Feature.unansweredQuestions > 0

Could be used to identify Jira issues that need further information before they could be developed.

image-20241013-124435.pngImage Added
Info

Combine attributes

You can combine Feature attributes in the same search query to give you more precise results

Feature.questions > 0 AND Feature.unansweredQuestions = 0

Could be used to better identify Jira issues that have been discussed with the team and have had all the questions answered and perhaps are ready to go into the Sprint backlog.

image-20241013-124732.pngImage Added

Feature.

...

text to expand

...

Attribute name

...

Type

...

Description

...

Examples

...

Feature.userStories

...

Number

...

How many “complete” User Stories the Feature contains.
Complete in this case means that the User Story entered after the Feature keyword there is some text after the 3 common keywords

...

rules

Type - Number

Description: total number of Rules the Feature contains. There needs to be some text after the Rule keyword in order for the Rule to count towards this number.

Expand
titleExamples

Feature.rules > 0

Could be used to find Jira issues which have at least some Acceptance Criteria entered. Rules in Features files essentially are the acceptance criteria.

image-20241013-125341.pngImage Added

Feature.leastScenariosInRule

Type - Number

Description: lowest number of Scenarios contained in any Rule inside the overall Feature

Expand
titleExamples

Feature.leastScenariosInRule = 0

Could be used to find Issues where there is at least one Rule without any Scenarios

image-20241013-151846.pngImage Added

This same query will also include any issues where there is a Rule with Scenarios however there is no text after the Rule keyword (i.e. an empty Rule card), meaning the Rule is not yet defined.

image-20241013-152036.pngImage Added

Feature.mostScenariosInRule

Type - Number

Description: highest number of Scenarios contained in any Rule inside the overall Feature

Expand
titleExamples

Feature.mostScenariosInRule > 5

Could be used to find Issues where there are perhaps too many Scenarios in a Rule which could mean that some of the examples could be potentially moved under a new not yet captured rule.

image-20241013-152545.pngImage Added

Feature.scenarios

Type - Number

Description: total number of Scenarios the Feature contains. All valid scenario keywords are taken into account i.e. Scenario, Example, Scenario Outline or Scenario Template.

Expand
titleExamples

Feature.scenarios = 0

Could be used to find Jira issues that do not yet have any examples of behaviour

image-20241013-130117.pngImage Added

Feature.leastStepsInScenario

Type - Number

Description: lowest number of Steps contained in any of the Scenarios inside the overall Feature

Expand
titleExamples

Feature.leastStepsInScenario = 0

Could be used to find Jira issues where there is at least one Scenario which hasn’t been discussed to the level of concrete steps that would demonstrate the desired behaviour.

image-20241013-153354.pngImage Added

Feature.mostStepsInScenario

Type - Number

Description: highest number of Steps contained in any of the Scenarios inside the overall Feature

Expand
titleExamples

Feature.mostStepsInScenario > 5

Could be used to find Jira issues that have Scenarios with potentially too many steps which could mean that the Steps were used to describe ‘how’ functionally was implemented and not ‘what’ behavior was required which is an anti pattern in BDD.

image-20241013-155032.pngImage Added

Feature.warnings

Type - Number

Description: total number of warnings the Feature contains according to the syntax of Gherkin

Expand
titleExamples

Feature.warnings > 0

Could be used to find indentation warnings for example

image-20241013-155644.pngImage Added

Or missing data table values

image-20241015-102441.pngImage Added

Feature.errors

Type - Number

Description: total number of errors the Feature contains according to the syntax of Gherkin

Expand
titleExamples

Feature.errors > 0

Could be used to find incorrectly entered text

image-20241013-160215.pngImage Added

Or structurally incorrect data tables

image-20241013-160718.pngImage Added

Feature.lines

Type - Number

Description: total lines in a Feature

Expand
titleExamples

Feature.lines > 100
Could be used to find overly long Features that should perhaps be split

image-20241014-084643.pngImage Added

Feature.lastUpdatedDate

Type - Date

Description: the time and date the last time the Feature was updated by any user

Expand
titleExamples

Feature.lastUpdatedDate > startOfWeek()

Could be used to find all Jira issues where the Feature was updated since the start of the week

image-20241014-085612.pngImage Added

Feature.lastUpdatedDate > startOfDay(9h)

Could be used to find all Jira issues where Feature has been updated since 9:00AM of current day

image-20241014-085856.pngImage Added

Feature.lastUpdatedBy

Type - User

Description: the user who last updated the Feature

Expand
titleExamples

Feature.lastUpdatedBy = currentUser()

Could be used to find all Jira issues where I (current user) was the last to update the Feature

image-20241014-091549.pngImage Added

Feature.updatedBy

Type - User

Description: any user that made at least one update to the Feature

Expand
titleExamples

Feature.updatedBy = currentUser()

Could be used to find all Jira issues where I (current user) made at least one update to the Feature

image-20241014-105134.pngImage Added

Built-in Editor Search

When in Gherkin Text Editor mode use the toolbar button highlighted below to open the built-in search pop up box in the top right of the editor. Type a search phrase and press the Enter key - match results will get highlighted in yellow.

...

Info

Folded sections are also searched

Using built-in search is superior to using the standard browser find functionally in that it also searches in lines that are currently folded

image-20241014-185901.pngImage Added