From 6cfc5aa42368959fdf7b2eb95149c0d5ecd1e465 Mon Sep 17 00:00:00 2001
From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com>
Date: Sat, 19 Sep 2026 10:07:05 +0000
Subject: [PATCH] fix(docs): repoint references to the relocated contributing
 guide

The guide moved to .github/CONTRIBUTING.md. These references still resolved
against the old root location, or were left half-updated, so they 404 or land
on the wrong file from where they are written.

- `QUICKSTART-DEV.adoc`: CONTRIBUTING.md -> .github/CONTRIBUTING.md
- `README.adoc`: CONTRIBUTING.md -> .github/CONTRIBUTING.md
- `ROADMAP.adoc`: CONTRIBUTING.md -> .github/CONTRIBUTING.md
- `SECURITY.adoc`: CONTRIBUTING.md -> .github/CONTRIBUTING.md
- `.github/CONTRIBUTING.md`: the guide's usage link now reaches docs/usage.adoc from .github/
---
 .github/CONTRIBUTING.md | 2 +-
 QUICKSTART-DEV.adoc     | 2 +-
 README.adoc             | 2 +-
 ROADMAP.adoc            | 2 +-
 SECURITY.adoc           | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index db8643b..397f18d 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -9,7 +9,7 @@ SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) <6759885+hyper
 ## Audience
 
 Developers working **on** `anvomidav`. For consumers (people calling or
-depending on it) see <a href="./usage.adoc" class="adoc">usage</a>.
+depending on it) see <a href="../docs/usage.adoc" class="adoc">usage</a>.
 
 ## Local-dev setup
 
diff --git a/QUICKSTART-DEV.adoc b/QUICKSTART-DEV.adoc
index b3eae85..7914bd1 100644
--- a/QUICKSTART-DEV.adoc
+++ b/QUICKSTART-DEV.adoc
@@ -36,4 +36,4 @@ just assail    # run panic-attacker security scan
 
 == Contributing
 
-See link:CONTRIBUTING.md[CONTRIBUTING.md] for guidelines.
+See link:.github/CONTRIBUTING.md[CONTRIBUTING.md] for guidelines.
diff --git a/README.adoc b/README.adoc
index e715353..c86365e 100644
--- a/README.adoc
+++ b/README.adoc
@@ -60,7 +60,7 @@ guix shell         # Guix users
 == Documentation
 
 * link:ROADMAP.adoc[Roadmap] — Development phases and milestones
-* link:CONTRIBUTING.md[Contributing] — How to participate
+* link:.github/CONTRIBUTING.md[Contributing] — How to participate
 * link:SECURITY.md[Security Policy] — Vulnerability reporting
 * link:CODE_OF_CONDUCT.md[Code of Conduct] — Community standards
 
diff --git a/ROADMAP.adoc b/ROADMAP.adoc
index 9afd84c..0c0d3be 100644
--- a/ROADMAP.adoc
+++ b/ROADMAP.adoc
@@ -138,4 +138,4 @@ This roadmap is a living document. To propose changes:
 2. Submit a PR for specific task additions
 3. Use issues to claim tasks you want to work on
 
-See link:CONTRIBUTING.md[CONTRIBUTING.md] for workflow details.
+See link:.github/CONTRIBUTING.md[CONTRIBUTING.md] for workflow details.
diff --git a/SECURITY.adoc b/SECURITY.adoc
index 775e783..37cfe21 100644
--- a/SECURITY.adoc
+++ b/SECURITY.adoc
@@ -410,7 +410,7 @@ When using Nextgen Languages, we recommend:
 * https://github.com/hyperpolymath/nextgen-languages/security/advisories[Security
 Advisories]
 * link:CHANGELOG.md[Changelog]
-* link:CONTRIBUTING.md[Contributing Guidelines]
+* link:.github/CONTRIBUTING.md[Contributing Guidelines]
 * https://cve.mitre.org/[CVE Database]
 * https://www.first.org/cvss/calculator/3.1[CVSS Calculator]