Skip to content
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

Replace "policy" terminology #698

Open
ahouseholder opened this issue Feb 20, 2025 · 8 comments
Open

Replace "policy" terminology #698

ahouseholder opened this issue Feb 20, 2025 · 8 comments
Labels
enhancement New feature or request

Comments

@ahouseholder
Copy link
Contributor

Is your feature request related to a problem? Please describe.

Using the word "policy" to describe the mapping of a combination of decision point values to an outcome set might be accurate in an academic software-oriented environment. However, we have received word from SSVC users that the word "policy" can bring unwarranted attention to what SSVC is and does.

Describe the solution you'd like

We should find a less contentious term, as it's not our intention to claim that SSVC dictates any sort of "capital-P Policy" in any setting. It's just a name for the mapping of a full enumeration of a decision point group's values to an outcome set.

To resolve this issue, we should:

  • have a discussion of alternative terms (that can happen here in this issue)
  • choose one
  • implement it in both the software tooling and text content
@ahouseholder ahouseholder added the enhancement New feature or request label Feb 20, 2025
@ahouseholder
Copy link
Contributor Author

ahouseholder commented Feb 20, 2025

This issue does not affect the intent of #592: we still need a technical object to represent the data, we just should call it whatever we decide here. No need to delay #592 waiting for this to resolve, we can always fix whatever we do there based on the outcome here.

@ahouseholder
Copy link
Contributor Author

I asked ChatGPT to generate a few suggestions:

Here are some possible replacements:

Decision Framework – Emphasizes that it’s a structured method for making choices based on set criteria.
Decision Model – Highlights the systematic nature of the decision-making process.
Outcome Matrix – Focuses on the mapping aspect, where inputs (decision points) correspond to specific outcomes.
Response Map – Suggests a structured way to guide actions based on vulnerabilities.
Prioritization Schema – Makes it clear that this is about ranking and responding rather than setting policy.
Action Guide – Simplifies the concept while still implying structured decision-making.
Decision Mapping – Reinforces the idea of predefined pathways based on inputs.

If the SSVC project is concerned with avoiding confusion while maintaining clarity, I’d recommend Decision Framework or Outcome Matrix as strong replacements. They retain the structured nature of SSVC’s mapping while avoiding unintended associations with governmental or organizational policy-making authority.

I'm not offering my opinion on these yet, I just wanted to put them here to spark discussion.

@sei-vsarvepalli
Copy link
Contributor

sei-vsarvepalli commented Feb 20, 2025

+1 for Decision Framework or Prioritization Framework which both represent close to what SSVC is doing and less authoritative burden on the Coordinators

@laurie-tyz
Copy link
Contributor

laurie-tyz commented Feb 20, 2025 via email

@sei-renae
Copy link
Contributor

+1 for Prioritization Framework (because 'Prioritization' is used throughout the in-review Explanation/Overview document)

@j---
Copy link
Collaborator

j--- commented Mar 5, 2025

a combination of decision point values to an outcome set

Could it just be "decision"?

@ahouseholder
Copy link
Contributor Author

So just baselining terminology here, the object we're talking about would be the thing that serves as the object from which a csv-tabular representation is derived.

In my mind, a "decision" is a row in such a table but not the table itself (a set of specific decision table values + a specific outcome).

But I also just became aware (or was at least reminded in a way that it seemed new in the moment) of the fact that Decision Table is the compound noun people already use to describe such things:

so maybe that's the best choice because it's

  • already in widespread use elsewhere
  • evocative of what it actually is -- nobody will be surprised when a "Decision Table" shows up represented as a CSV file
  • avoids nebulous words like "framework"
  • continues the pattern of using "Decision" as a modifier to a descriptive noun (Decision Point, Decision Point Value, Decision Model, etc.)

@j---
Copy link
Collaborator

j--- commented Mar 11, 2025

I like decision table personally. Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

5 participants