docs: rename docs/ -> serverAppConfigs-docs/ per system-wide PROJECTNAME-docs convention
All in-repo path references (AGENTS.md, README, old scripts, report artifacts,
test code paths) rewritten in the same commit; focused-test map extended for
.gitignore, old/scripts/*, dankclaw/comfyui/*, and report/* per this repo's
own convention ('add one before committing'). Obsidian wikilinks are
title-based and unaffected.
This commit is contained in:
1 parent
6d4a96a423
commit
5829a0bfe8
140 files changed
+1820
-86
No files matched your search
@@ -4,7 +4,7 @@
|
||||
# bare compose container never comes back (rootless Podman has no boot-time
|
||||
# auto-start for bare containers; `restart: unless-stopped` does not survive
|
||||
# the explicit stop that shutdown performs). See AGENTS.md "Boot Persistence
|
||||
# & Self-Healing" and docs/Infrastructure/Caddy.md.
|
||||
# & Self-Healing" and serverAppConfigs-docs/Infrastructure/Caddy.md.
|
||||
|
||||
load helpers
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
# passes /dev/kfd + /dev/dri, adds the video group (render is unmappable in
|
||||
# rootless), and drops --cpu.
|
||||
# The four compose-wiring tests below are active (un-skipped). See
|
||||
# docs/Research/ComfyUI ROCm and Vulkan.md.
|
||||
# serverAppConfigs-docs/Research/ComfyUI ROCm and Vulkan.md.
|
||||
|
||||
load helpers
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@ REMOTE_DEPLOY="$REPO_ROOT/scripts/deploy-remote.sh"
|
||||
|
||||
@test "deployment planner maps SearXNG changes to SearXNG only" {
|
||||
run python3 "$PLANNER" --target dankclaw --paths \
|
||||
shared/searxng/settings.yml docs/Dankclaw/SearXNG.md
|
||||
shared/searxng/settings.yml serverAppConfigs-docs/Dankclaw/SearXNG.md
|
||||
[ "$status" -eq 0 ]
|
||||
[ "$output" = "searxng" ]
|
||||
}
|
||||
@@ -42,7 +42,7 @@ REMOTE_DEPLOY="$REPO_ROOT/scripts/deploy-remote.sh"
|
||||
|
||||
@test "documentation-only changes plan no runtime deployment" {
|
||||
run python3 "$PLANNER" --target dankclaw --paths \
|
||||
docs/Architecture/Deployment\ Flow.md docs/Dankclaw/SearXNG.md
|
||||
serverAppConfigs-docs/Architecture/Deployment\ Flow.md serverAppConfigs-docs/Dankclaw/SearXNG.md
|
||||
[ "$status" -eq 0 ]
|
||||
[ -z "$output" ]
|
||||
}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
#!/usr/bin/env bats
|
||||
# Seam: documentation completeness.
|
||||
# Every service defined in a compose.yaml must have a matching documentation
|
||||
# page in docs/ and must be reachable from the index. This is the "docs first"
|
||||
# page in serverAppConfigs-docs/ and must be reachable from the index. This is the "docs first"
|
||||
# contract of this repo: no service ships without documentation.
|
||||
|
||||
load helpers
|
||||
@@ -9,12 +9,12 @@ load helpers
|
||||
@test "every compose service has a docs page" {
|
||||
while IFS= read -r f; do
|
||||
while IFS= read -r svc; do
|
||||
# service name is the docs slug: RomM -> docs/Dankserver/RomM.md
|
||||
# service name is the docs slug: RomM -> serverAppConfigs-docs/Dankserver/RomM.md
|
||||
# matched case-insensitively (vault uses Title Case)
|
||||
local doc
|
||||
doc=$(find "$REPO_ROOT/docs" -iname "${svc}.md" 2>/dev/null | head -1)
|
||||
doc=$(find "$REPO_ROOT/serverAppConfigs-docs" -iname "${svc}.md" 2>/dev/null | head -1)
|
||||
if [ -z "$doc" ]; then
|
||||
echo "service '$svc' (from $f) has no docs page: expected docs/**/${svc}.md"
|
||||
echo "service '$svc' (from $f) has no docs page: expected serverAppConfigs-docs/**/${svc}.md"
|
||||
return 1
|
||||
fi
|
||||
done < <(services_in "$f")
|
||||
@@ -22,7 +22,7 @@ load helpers
|
||||
}
|
||||
|
||||
@test "docs index links every docs page" {
|
||||
local index="$REPO_ROOT/docs/index.md"
|
||||
local index="$REPO_ROOT/serverAppConfigs-docs/index.md"
|
||||
[ -f "$index" ] || { echo "missing $index"; return 1; }
|
||||
while IFS= read -r page; do
|
||||
local base
|
||||
@@ -31,5 +31,5 @@ load helpers
|
||||
echo "docs page $base is not linked from $index"
|
||||
return 1
|
||||
}
|
||||
done < <(find "$REPO_ROOT/docs" -name '*.md' -not -name 'index.md' -not -path '*/.obsidian/*' | sort)
|
||||
done < <(find "$REPO_ROOT/serverAppConfigs-docs" -name '*.md' -not -name 'index.md' -not -path '*/.obsidian/*' | sort)
|
||||
}
|
||||
Reference in new issue
Block a user