Minor refactor of Outcome and Overview documentation (#972)

Author: ahouseholder

data/schema/v2/README.md

@@ -4,6 +4,6 @@
 
 We are now automatically generating the schema files for SSVC based on their
 corresponding Pydantic models. This allows us to keep the schema files in sync
-with the code more easily. However, it required us to make some changes to the 
-file names. So we've left behind some soft links from the original file names 
-to help ease the transition.
+with the code more easily. However, it required us to make some changes to the
+file names. So we've left behind some soft links from the original file names
+to help ease the transition.

docs/adr/0013-ssvc-project-versions.md

@@ -29,6 +29,7 @@ For the overall SSVC project and documentation, we need a scheme that better ref
 - **Patch** = subsequent updates in the same month or smaller corrections  
 
 **Significant updates** include:  
+
 - Adding or restructuring sections in ways that affect usability  
 - Adding/revising decision points, tables, or other SSVC objects  
 - Adding features that change how SSVC is applied  
@@ -39,6 +40,7 @@ Months use single digits (`2025.6`) to keep versions concise.
 ## Rationale
 
 CalVer suits SSVC’s character as a living framework:  
+
 - Clearly signals recency (date in the version number)  
 - Fits both documentation-focused and object-focused updates  
 - Avoids SemVer debates over what counts as “major” or “minor”  
@@ -61,6 +63,7 @@ The CalVer scheme will be applied via Git tags and GitHub releases.
 ## Alternatives Rejected
 
 **Continue SemVer for project/docs**  
+
 - **Good:** Maintains continuity  
 - **Bad:** Cannot easily express documentation updates independent of object versions  
 

docs/howto/index.md

@@ -7,7 +7,7 @@
     - An interest in using SSVC in a vulnerability management process
     - Basic familiarity with SSVC
 
-    If you are unfamiliar with SSVC, we suggest you start with the [Learning SSVC](../tutorials/index.md) section.
+    If you are unfamiliar with SSVC, we suggest you start with the [SSVC Overview](../tutorials/ssvc_overview.md) section.
     [Understanding SSVC](../topics/index.md) provides necessary background detail.
     For technical reference, see [Reference](../reference/index.md).
 

docs/howto/tools/containers.md

@@ -50,4 +50,3 @@ docker-compose --project-directory=docker up api
 ```
 
 Then browse to `http://localhost:8001/docs` to access the API documentation.
-

docs/howto/using_epss/epss_percentiles.md

@@ -160,7 +160,6 @@ the prioritization of vulnerabilities based on their EPSS percentiles.
     This way, even if multiple vulnerabilities fall into the same SSVC category,
     you can still prioritize them based on their predicted likelihood of exploitation.
 
-
 ## Conclusion
 
 In this how-to, we've demonstrated how to use EPSS percentiles as an amplifier

docs/index.md

@@ -10,14 +10,14 @@ We have organized the SSVC documentation into four main sections:
 
 <div class="grid cards" markdown>
 
-- :fontawesome-regular-eye:{ .lg .middle } [**SSVC Overview**](ssvc_overview.md)
+- :fontawesome-regular-eye:{ .lg .middle } [**SSVC Overview**](tutorials/ssvc_overview.md)
 
     ---
 
     A beginner's guide to SSVC.
     This section is for people who have never heard of SSVC.
 
-    [:octicons-arrow-right-24: An Overview of SSVC](ssvc_overview.md)
+    [:octicons-arrow-right-24: An Overview of SSVC](tutorials/ssvc_overview.md)
 
 - :material-clipboard-check:{ .lg .middle } [**SSVC How To**](howto/index.md)
 

docs/reference/code/decision_point_groups.md

@@ -3,7 +3,7 @@
 Decision Point groups provide collections of related Decision Points for some
 specific purpose.
 
-With the introduction of [Decision Tables](decision_tables.md), 
+With the introduction of [Decision Tables](decision_tables.md),
 Decision Point groups are less important than they once were, and may be
 removed in a future release.
 However, they can still be useful for documentation and
@@ -17,4 +17,4 @@ for some programmatic uses.
 
 ## CVSS Decision Point Groups
 
-::: ssvc.dp_groups.cvss.collections
+::: ssvc.dp_groups.cvss.collections

docs/reference/code/decision_points.md

@@ -4,4 +4,4 @@
 
 ::: ssvc.decision_points.base
 
-::: ssvc.decision_points.helpers
+::: ssvc.decision_points.helpers

docs/reference/code/decision_tables.md

@@ -4,4 +4,4 @@
 
 ::: ssvc.decision_tables.base
 
-::: ssvc.decision_tables.helpers
+::: ssvc.decision_tables.helpers

docs/reference/code/index.md

@@ -1,10 +1,14 @@
 # SSVC Code Documentation
 
 This section provides documentation for the SSVC Python modules.
+
 These include:
 
-- [Decision Points](decision_points.md) and [Outcomes](outcomes.md) 
+- [Decision Points](decision_points.md)
 - [Decision Tables](decision_tables.md)
+- [Decision Point Groups](decision_point_groups.md) (Deprecated)
+- [Namespaces](namespaces.md)
+- [Selections](selection.md)
 - [CSV Analyzer](analyze_csv.md)
 - [Policy Generator](policy_generator.md)
 - [Namespaces](namespaces.md)