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

Update description of Human Impact #292

Closed
jeroenh opened this issue Aug 28, 2023 · 2 comments · Fixed by #476
Closed

Update description of Human Impact #292

jeroenh opened this issue Aug 28, 2023 · 2 comments · Fixed by #476
Assignees
Labels
documentation Improvements or additions to documentation
Milestone

Comments

@jeroenh
Copy link
Contributor

jeroenh commented Aug 28, 2023

Most new users of SSVC will now not know anything about the history of SSVC. So an introduction starting with "we changed this from a previous version" is not helpful to most readers. I can try to write up a new text for this and move the remark about changing from the pilot to a footnote?

@ahouseholder
Copy link
Contributor

Recent discussions might be leading us towards framing the "compound decision points" like Human Impact and Utility as notational convenience to get the visual representation as a tree to fit onto one page, but not first-order objects in the way that the other decision points are.

In light of this, it's likely that how the Human Impact section shows up in the documentation will change significantly anyway, so it might make more sense to hold off on rewriting the intro to fit in better where it currently lives.

"compound decision point" = a decision point that is fully specified by a complete mapping of other decision points

@ahouseholder ahouseholder added the documentation Improvements or additions to documentation label Aug 31, 2023
@j---
Copy link
Collaborator

j--- commented Sep 1, 2023

Agree with changing the intro. OK for it to be prioritized to be edited after the versioning documentation dust settles.

@ahouseholder ahouseholder added this to the SSVC 2023Q4 milestone Sep 27, 2023
@ahouseholder ahouseholder removed this from the SSVC 2023Q4 milestone Jan 16, 2024
@ahouseholder ahouseholder added this to the SSVC 202403 milestone Jan 23, 2024
@sei-bkoo sei-bkoo self-assigned this Feb 6, 2024
@ahouseholder ahouseholder linked a pull request Feb 19, 2024 that will close this issue
@ahouseholder ahouseholder modified the milestones: 2024.3, 1Q24 Jan 13, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants