Skip to content

#613: Added terminating specification item example to user guide. - #627

Merged
redcatbear merged 2 commits into
mainfrom
documentation/613_terminating-specification-item
Oct 9, 2026
Merged

redcatbear merged 2 commits into
mainfrom
documentation/613_terminating-specification-item

Conversation

@redcatbear

Copy link
Copy Markdown
Collaborator

Closes #613.

@redcatbear redcatbear self-assigned this Oct 8, 2026
@redcatbear redcatbear added the documentation User guides, turorials, specifications label Oct 8, 2026

@redcatbear redcatbear left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self review done. Readability improvements were applied already.

@redcatbear redcatbear added the ai-assisted Written with the help of an LLM label Oct 8, 2026
@sonarqubecloud

sonarqubecloud Bot commented Oct 9, 2026

Copy link
Copy Markdown


In a full trace, a chain ends at [terminating specification items](../../terminology.md#terminating-specification-item)—items that do not require further coverage (such as source code or test markers without a `Needs:` declaration).

When you trace with an artifact type filter, OFT strips all coverage requirements for artifact types that are not in the filter list. For instance, when Soeren runs `oft trace -a feat,req doc/`, a system requirement that normally declares `Needs: arch` has its `arch` requirement removed during the trace. This *artificially terminates* the requirement items at the boundary of the selected artifact types, allowing the trace to pass without missing-coverage errors for downstream artifacts that have not yet been written.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Good explanation!

@redcatbear
redcatbear merged commit f2b92a2 into main Oct 9, 2026
14 checks passed
@redcatbear
redcatbear deleted the documentation/613_terminating-specification-item branch October 9, 2026 10:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-assisted Written with the help of an LLM documentation User guides, turorials, specifications

Projects

Status: ✅ Closed

Development

Successfully merging this pull request may close these issues.

Add back example with traceability chain

2 participants