Skip to content

docs: add inline SBDL declarations to Gherkin feature files#1172

Closed
Copilot wants to merge 2 commits intodocs/generate-test-spec-and-traceabilityfrom
copilot/sub-pr-1166
Closed

docs: add inline SBDL declarations to Gherkin feature files#1172
Copilot wants to merge 2 commits intodocs/generate-test-spec-and-traceabilityfrom
copilot/sub-pr-1166

Conversation

Copy link
Contributor

Copilot AI commented Feb 27, 2026

Embeds SBDL declarations directly in the Gherkin .feature files instead of deriving them via Python conversion scripts, keeping definitions close to the source they describe.

Changes

  • Added # @sbdl inline comments directly below each Feature:, Rule:, and Scenario: keyword line in all 6 feature files under test/cpp/features/
  • Uses test-specification mapping as the canonical inline form:
    • Features → aspect (slug identifier, e.g. compatibility)
    • Rules → requirement (REQ ID slug, e.g. req-comp-0001) with aspect is <feature-slug>
    • Scenarios → test with requirement is <req-slug>
  • No custom:title — identifiers are short meaningful slugs; the Gherkin element name is the human-readable title
Feature: Compatibility
  # @sbdl compatibility is aspect { description is "As a software craftsperson, I want my development environment to be compatible with commonly used tools and systems." }

  @REQ-COMPAT-0001
  Rule: Open Container Initiative (OCI) Image Specification
    # @sbdl req-compat-0001 is requirement { description is "amp-devcontainer images *SHALL* be compatible with the [OCI image specification](...)" aspect is compatibility }

Running sbdl test/cpp/features/*.feature now extracts all 31 SBDL elements (6 aspects, 23 requirements, 2 tests) directly from the annotated feature files.


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: rjaegers <45816308+rjaegers@users.noreply.github.com>
@sonarqubecloud
Copy link

Copilot AI changed the title [WIP] Add unified SBDL document generation approach docs: add inline SBDL declarations to Gherkin feature files Feb 27, 2026
@rjaegers Ron (rjaegers) deleted the copilot/sub-pr-1166 branch February 28, 2026 14:06
@github-actions
Copy link
Contributor

Pull Request Report (#1172)

Static measures

Description Value
Number of added lines 31
Number of deleted lines 0
Number of changed files 6
Number of commits 2
Number of reviews 0
Number of comments (w/o review comments) 1
Number of reviews that contains a comment to resolve 0
Number of reviews that requested a change from the author 0
Number of reviews that approved the Pull Request 0
Get the total number of participants of a Pull Request 3

Time related measures

Description Value
PR lead time (from creation to close of PR) 21.5 Hours
Time that was spend on the branch before the PR was created 1 Sec
Time that was spend on the branch before the PR was merged 0 Sec
Time to merge after last review 0 Sec

Status check related measures

Description Value
Total runtime for last status check run (Workflow for PR) 27 Sec
Total time spend in last status check run on PR 29 Sec

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants