Expanded terms with descriptions and anchors

risk-first · Jun 18, 2024 · d4ef375 · d4ef375
1 parent 552758d
commit d4ef375
Show file tree

Hide file tree

Showing 10 changed files with 47 additions and 16 deletions.
diff --git a/docs/bets/Coding-Bets.md b/docs/bets/Coding-Bets.md
@@ -7,7 +7,7 @@ featured:
   class: bg1
   element: '<image-artifact imgsrc="/public/templates/risk-first/posts/cards.svg">Coding Bets</image-artifact>'
 tags:
- - Bets
+ - Bet
  - Refactoring
 sidebar_position: 2
 tweet: yes

diff --git a/docs/bets/Debugging-Bets.md b/docs/bets/Debugging-Bets.md
@@ -7,7 +7,7 @@ featured:
   class: bg1
   element: '<image-artifact imgsrc="/public/templates/risk-first/posts/cards.svg">Debugging Bets</image-artifact>'
 tags:
- - Bets
+ - Bet
 sidebar_position: 3
 tweet: yes
 ---

diff --git a/docs/bets/Purpose-Development-Team.md b/docs/bets/Purpose-Development-Team.md
@@ -8,7 +8,7 @@ featured:
   class: bg1
   element: '<agent-artifact>Balance Of Risk</agent-artifact>'
 tags:
- - Bets
+ - Bet
  - Balance Of Risk
 sidebar_position: 1
 tweet: yes

diff --git a/docs/risks/Risk-Landscape.md b/docs/risks/Risk-Landscape.md
@@ -6,7 +6,8 @@ tags:
  - Risk Landscape
 
 definitions:
- - Risk Landscape
+ - name: Risk Landscape
+   description: A hypothetical landscape on which risks can be placed. Taking Action means making a move on the Risk Landscape to reposition a project so that it has a different profile of Attendant Risks.
 
 featured: 
   class: c

diff --git a/docs/thinking/A-Simple-Scenario.md b/docs/thinking/A-Simple-Scenario.md
@@ -13,9 +13,15 @@ tags:
  - Meeting Reality
 
 definitions:
- - Attendant Risk
- - Hidden Risk
- - Goal 
+ - name: Attendant Risk
+   description:  A Risk you expect to face as the result of Taking Action.
+   anchor: attendant-risks
+ - name: Hidden Risk
+   description: Risks you aren't aware of when you consider Taking Action. i.e. an unknown unknown.
+   anchor: hidden-risks
+ - name: Goal
+   description: A picture of the future that an individual or team carries within their Internal Model; An imagined destination on the Risk Landscape. A specific Upside Risk we'd like to nurture and realize.
+   anchor: goal-in-mind
 
 featured: 
   class: bg3

diff --git a/docs/thinking/Cadence.md b/docs/thinking/Cadence.md
@@ -10,6 +10,9 @@ tags:
  - Thinking Risk-First
  - Feedback Loop
  - Meet Reality
+definitions:
+ - name: Feedback Loop
+   description: The process of testing an Internal Model, through taking action to Meet Reality. Typically, we talk about short or long feedback loops, depending on the intervals between Meeting Reality.
 sidebar_position: 9
 redirect_from: 
  - /Cadence

diff --git a/docs/thinking/Consider-Payoff.md b/docs/thinking/Consider-Payoff.md
@@ -10,15 +10,28 @@ tags:
  - Goal
  - Attendant Risk
  - Risk Landscape
- - Bets
+ - Bet
  - Payoff
  - Stake
  - Expected Value
+ - Expected Return
 definition:
- - Bets
- - Payoff
- - Stake
- - Expected Value 
+ - name: Bet
+   description: Taking a decision to move somewhere new on the Risk Landscape and change the Balance Of Risk.
+   anchor: the-structure-of-a-bet
+ - name: Payoff
+   description: The payoff (or gross winnings) from winning a bet.
+   anchor: the-structure-of-a-bet
+ - name: Stake
+   description: The amount you have to pay to take a bet.
+   anchor: the-structure-of-a-bet
+ - name: Expected Value 
+   description: The probability-weighted average value of the outcome. 
+   anchor: the-structure-of-a-bet
+ - name: Expected Return 
+   description: The probability-weighted return of the bet.
+   anchor: the-structure-of-a-bet
+
 sidebar_position: 10
 tweet: yes
 ---

diff --git a/docs/thinking/De-Risking.md b/docs/thinking/De-Risking.md
@@ -11,7 +11,8 @@ tags:
  - Take Action
  - Risk Landscape
 definitions:
- - Take Action
+ - name: Take Action
+   description: Refers to any activity in the project. Actions are taken in order to manage some risk. At the same time, Taking Action usually means interacting with reality and updating the Internal Model.
 sidebar_position: 8
 redirect_from: 
  - /De-Risking

diff --git a/docs/thinking/Health.md b/docs/thinking/Health.md
@@ -7,6 +7,10 @@ featured:
 tags: 
  - Thinking Risk-First
  - Feedback Loop
+ - Risk
+definition:
+ - name: Risk
+   description: A possibility of loss or cost.   
 sidebar_position: 7
 redirect_from: 
  - /Health

diff --git a/docs/thinking/Meeting-Reality.md b/docs/thinking/Meeting-Reality.md
@@ -15,9 +15,12 @@ tags:
  - Meet Reality
  - Internal Model
 definitions:
- - Meet Reality
- - Feedback Loop
- - Internal Model
+ - name: Meet Reality
+   description: Any moment where we test an Internal Model by exposing it's predictive power against reality. 
+ - name: Internal Model
+   description: The model of reality held by an individual, team, software system or other Agent. 
+   anchor: different-internal-models
+
 sidebar_position: 4
 redirect_from: 
  - /Meeting-Reality