chore

Author: denisecase

.github/workflows/links.yml

@@ -27,8 +27,8 @@ jobs:
       pull-requests: write
 
     steps:
-      - name: A1) Checkout repository code
-        uses: actions/checkout@v6 # OBS: v6 current as of Dec 2025
+      - name: 1) Checkout repository code
+        uses: actions/checkout@v6
 
       - name: 2) Check links with Lychee
         uses: lycheeverse/lychee-action@v2

.yamllint.yml

@@ -1,3 +1,7 @@
+# ============================================================
+# .yamllint.yml (YAML linting configuration)
+# ============================================================
+
 # WHY: Enforce YAML correctness without arbitrary style constraints.
 # OBS: Default yamllint rules conflict with GitHub Actions YAML.
 #      Line length, document start, truthy, and comment spacing are intentionally disabled.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Denise M. Case
+Copyright (c) 2025-2026 Denise M. Case
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -19,29 +19,6 @@ lake build
 lake exe verify
 ```
 
-## Developer (running pre-commit)
-
-Pre-commit is optional; CI will report exact commands if it fails.
-
-Steps to run pre-commit locally. Install `uv`.
-
-Initialize once:
-
-```shell
-uv self update
-uvx pre-commit install
-uvx pre-commit run --all-files
-```
-
-Save progress as needed:
-
-```shell
-git add -A
-# If pre-commit makes changes, re-run `git add -A` before committing.
-git commit -m "update"
-git push -u origin main
-```
-
 ## Annotations
 
 [ANNOTATIONS.md](./ANNOTATIONS.md)

lychee.toml

@@ -1,14 +1,15 @@
+# ============================================================
+# lychee.toml (Lychee link checker configuration)
+# ============================================================
+
+# REQ.PROJECT: Automatic link checking using GitHub Actions and Lychee.
 # WHY-FILE: Shared Lychee configuration (lychee.toml) for documentation-heavy repositories.
-# REQ.PROJECT: Link checking MUST be non-flaky and CI-safe.
+# REQ: Link checking MUST be reliable and CI-safe.
 # WHY: Configures Lychee link checker behavior for CI/CD.
 # OBS: Flat structure required by lychee v0.22+; no nested sections.
 # OBS: No path exclusions; all documentation files are expected to be link-clean.
-# OBS: Link integrity supports Structural Explainability (SE)
-#      by preserving stable, reconstructible references over time.
-# OBS: Link integrity also benefits Contextual Evidence & Explanations (CEE)
-#      by maintaining the availability of cited evidence and provenance,
-#      without enforcing interpretation.
-
+# OBS: Link integrity preserves stable, reconstructible references over time.
+# OBS: Link integrity maintains connections to external resources.
 
 # WHY: Control verbosity and CI-friendly output
 verbose = "info"   # WHY: Balance between detail and noise