Skip to content

Commit 96fd1af

Browse files
authored
Refactor default safety values tip into an includable file (#1015)
2 parents 73f1938 + 94e55c4 commit 96fd1af

File tree

3 files changed

+11
-6
lines changed

3 files changed

+11
-6
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
!!! tip "Default Safety Values"
2+
3+
If the decision maker knows nothing about the environment in which the device is used, we suggest assuming a
4+
[*marginal* *Safety Impact*](../reference/decision_points/safety_impact.md).
5+
This position is conservative, but software is thoroughly embedded in daily life now, so we suggest that the decision
6+
maker provide evidence that no one's well-being will suffer.

docs/howto/bootstrap/collect.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -104,12 +104,7 @@ we can suggest something like defaults for some decision points.
104104
[*Value Density*](../../reference/decision_points/value_density.md) should always be answerable; if the product is uncommon, it is probably
105105
[*diffuse*](../../reference/decision_points/value_density.md).
106106

107-
!!! tip "Default Safety Values"
108-
109-
If the decision maker knows nothing about the environment in which the device is used, we suggest assuming a
110-
[*marginal*](../../reference/decision_points/safety_impact.md) [*Safety Impact*](../../reference/decision_points/safety_impact.md).
111-
This position is conservative, but software is thoroughly embedded in daily life now, so we suggest that the decision
112-
maker provide evidence that no one’s well-being will suffer.
107+
{% include-markdown "../../_includes/default_safety_values.md" %}
113108

114109
!!! tip "Default Mission Impact Values"
115110

docs/reference/decision_points/safety_impact.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ print(example_block(LATEST))
1414
- Safety Impact combines with [Mission Impact](./mission_impact.md) to
1515
inform [Human Impact](./human_impact.md).
1616

17+
{% include-markdown "../../_includes/default_safety_values.md" %}
18+
1719
We take an expansive view of safety, in which a safety violation is a violation of what the United States [Centers for Disease Control (CDC)](https://www.cdc.gov/hrqol/wellbeing.htm) calls **well-being**. Physical well-being violations are common safety violations, but we also consider economic, social, emotional, and psychological well-being to be important. Weighing fine differences among these categories is probably not possible, so we will not try. Each decision option lists examples of the effects that qualify for that value/answer in the various types of violations of well-being. These examples should not be considered comprehensive or exhaustive, but rather as suggestive.
1820
<!--The CDC webpage is better called a lit review. It has 74 citations on well-being across various fields. The following citations could reasonably be cited directly, rather than just referencing the CDC page:
1921
Frey BS, Stutzer A. Happiness and economics. Princeton, N.J.: Princeton University Press; 2002.
@@ -47,6 +49,8 @@ Aggregation suggests that the stakeholder’s response to this decision point ca
4749

4850
## Gathering Information About Safety Impact
4951

52+
{% include-markdown "../../_includes/default_safety_values.md" %}
53+
5054
The factors that influence the safety impact level are diverse.
5155
This paper does not exhaustively discuss how a stakeholder should answer a question; that is a topic for future work.
5256
At a minimum, understanding safety impact should include gathering information about survivability of the vulnerable component, determining available operator actions to compensate for the vulnerable component, understanding relevant insurance, and determining the viability of existing backup measures.

0 commit comments

Comments
 (0)