-
Notifications
You must be signed in to change notification settings - Fork 43
Add ADR-0014: Terminology shift from "decision tree" to "decision table" #1100
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 3 commits
b2e1644
9d2aa29
c395b3c
507d1ea
e405ce3
25b68d8
c48f706
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,66 @@ | ||||||
| --- | ||||||
| status: "accepted" | ||||||
| date: 2025-08-26 | ||||||
| --- | ||||||
| # Use "Decision Table" Instead of "Decision Tree" | ||||||
|
|
||||||
| ## Context and Problem Statement | ||||||
|
|
||||||
| SSVC uses a tabular model to map combinations of decision point values to | ||||||
| recommended actions. Historically, this model was referred to as a "decision | ||||||
| tree" or "decision policy" with both terms being used interchangeably in | ||||||
| documentation and tooling. However, "decision tree" has a well-established, | ||||||
| conflicting meaning in machine learning and statistics, and "decision policy" | ||||||
| has overloaded meanings beyond our intended usage. Using the "decision tree" | ||||||
| for both concepts creates confusion, especially for audiences familiar with data | ||||||
| science or machine learning. | ||||||
|
|
||||||
| ## Decision Drivers | ||||||
|
|
||||||
| - Avoid ambiguity with the machine learning and operations research concept of | ||||||
| "decision tree" | ||||||
| - Use a less contentious term than "policy" as we are not dictating "capital-P | ||||||
| Policy" | ||||||
| - Accurately describe the underlying SSVC data structure, which is a table of | ||||||
| decision points and outcomes | ||||||
| - Improve clarity in documentation, tooling, and communication with | ||||||
| practitioners | ||||||
| - Align terminology with the actual data representations used (CSV and JSON | ||||||
| tables) | ||||||
|
|
||||||
| ## Considered Options | ||||||
|
|
||||||
| - Switch to "decision framework" | ||||||
| - Switch to "decision table" | ||||||
|
|
||||||
|
Comment on lines
+34
to
+39
|
||||||
| ## Decision Outcome | ||||||
|
|
||||||
| Chosen option: 'Switch to "decision table"' | ||||||
|
||||||
| Chosen option: 'Switch to "decision table"' | |
| Chosen option: "Switch to decision table" |
Copilot
AI
Mar 27, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Missing space after the closing quote: "Decision table"accurately should be "Decision table" accurately.
| "Decision table"accurately describes the tabular structure used by | |
| "Decision table" accurately describes the tabular structure used by |
Uh oh!
There was an error while loading. Please reload this page.