cucumber / cucumber/website

Background may need clarification

Open
#103 5 comments 0 reactions 0 assignees View on GitHub
Dominant language
MDX
Stars
10
Forks
26
Avg merge
1d 23h
Merged PRs (30d)
37

Description

### 👓 What did you see?

According to the docs:

> You can only have one set of Background steps per Feature or Rule

https://cucumber.io/docs/gherkin/reference/#background

It's not clear to me whether:

a) Both feature and rule can have a background
b) Either feature or rule can have a background, but not both.

I think it's (a), but that sentence needs clarification.

### ✅ What did you expect to see?

Maybe something like this?

> A Feature can have only one set of Background steps. The same goes for a Rule. Both a Rule and its Feature may have a Background at the same time.

Contributor guide

Open the contributing guide

Research direction

Start with the linked Gherkin Background documentation and review the sentence about one set of Background steps per Feature or Rule. Clarify whether both a Feature and its Rule may define Background steps, then update the wording so the allowed combinations are unambiguous.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.