chore: add Hugo go.sum and update gitignore for Hugo artifacts

Add docs/go.sum (Hextra v0.12.3 checksums) produced by hugo mod tidy.
Update docs/go.mod with the resolved module version.
Ignore docs/.hugo_build.lock, docs/public/, and docs/resources/ —
all are generated by Hugo locally and not needed in the repo.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.gitignore

@@ -122,3 +122,9 @@ SERVICE-HEALTH.md
 
 # Diagnostic encryption keys — private key stays local with the maintainer
 keys/private/
+
+# Hugo (docs site)
+# Hugo build artifacts (docs site)
+docs/.hugo_build.lock
+docs/public/
+docs/resources/

docker-compose.docs.yml

@@ -15,8 +15,10 @@ services:
   hugo:
     image: hugomods/hugo:exts
     # --source docs/ because docs/ is the Hugo root inside the repo.
+    # --baseURL / overrides the production subpath (/Bose-SoundTouch/) so
+    # absolute links work at http://localhost:1313/ during local development.
     # The full repo is mounted so enableGitInfo can read git history.
-    command: server --source docs/ --bind 0.0.0.0 --buildDrafts --navigateToChanged
+    command: server --source docs/ --baseURL / --bind 0.0.0.0 --buildDrafts --navigateToChanged
     ports:
       - "1313:1313"
     volumes:

docs/content/docs/analysis/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Analysis & Research"
+weight: 4
+---

docs/content/docs/appendix/API-NAVIGATION-REFERENCE.md

@@ -1,5 +1,7 @@
 ---
 title: "Navigation API Reference"
+sidebar:
+  exclude: true
 ---
 
 # Navigation API Reference

docs/content/docs/appendix/CLAUDE.md

@@ -1,5 +1,7 @@
 ---
 title: "CLAUDE.md - Development Guidelines for Bose SoundTouch Project"
+sidebar:
+  exclude: true
 ---
 
 # CLAUDE.md - Development Guidelines for Bose SoundTouch Project

docs/content/docs/appendix/CONTENT-SELECTION-IMPLEMENTATION.md

@@ -1,5 +1,7 @@
 ---
 title: "Content Selection Implementation Summary"
+sidebar:
+  exclude: true
 ---
 
 # Content Selection Implementation Summary

docs/content/docs/appendix/DEVICE-CUSTOMIZATION-SETUP.md

@@ -1,5 +1,7 @@
 ---
 title: "Device Customization Setup Guide"
+sidebar:
+  exclude: true
 ---
 
 # Device Customization Setup Guide

docs/content/docs/appendix/DEVICE-LOGGING.md

@@ -1,5 +1,7 @@
 ---
 title: "Device Logging & Troubleshooting"
+sidebar:
+  exclude: true
 ---
 
 # Device Logging & Troubleshooting

docs/content/docs/appendix/DEVICE-SETUP.md

@@ -1,5 +1,7 @@
 ---
 title: "Bose SoundTouch Device Setup Flow"
+sidebar:
+  exclude: true
 ---
 
 # Bose SoundTouch Device Setup Flow

docs/content/docs/appendix/DIAGNOSTIC-EXPORT.md

@@ -1,5 +1,7 @@
 ---
 title: "Encrypted Diagnostic Export"
+sidebar:
+  exclude: true
 ---
 
 # Encrypted Diagnostic Export

docs/content/docs/appendix/EXTERNAL-SERVICES-ABSTRACTION.md

@@ -1,5 +1,7 @@
 ---
 title: "Technical Proposal: External Service Provider Abstraction"
+sidebar:
+  exclude: true
 ---
 
 # Technical Proposal: External Service Provider Abstraction

docs/content/docs/appendix/FEATURE_HISTORY.md

@@ -1,5 +1,7 @@
 ---
 title: "Feature Development History"
+sidebar:
+  exclude: true
 ---
 
 # Feature Development History

docs/content/docs/appendix/HOST-PORT-PARSING.md

@@ -1,5 +1,7 @@
 ---
 title: "Host:Port Parsing Feature"
+sidebar:
+  exclude: true
 ---
 
 # Host:Port Parsing Feature

docs/content/docs/appendix/MANUAL-NETWORK-DISCOVERY.md

@@ -1,5 +1,7 @@
 ---
 title: "Manual Network Discovery on macOS"
+sidebar:
+  exclude: true
 ---
 
 # Manual Network Discovery on macOS

docs/content/docs/appendix/NAVIGATION-GUIDE.md

@@ -1,5 +1,7 @@
 ---
 title: "Navigation and Station Management Guide"
+sidebar:
+  exclude: true
 ---
 
 # Navigation and Station Management Guide

docs/content/docs/appendix/OFFICIAL-API-VERIFICATION.md

@@ -1,5 +1,7 @@
 ---
 title: "Official SoundTouch Web API Verification"
+sidebar:
+  exclude: true
 ---
 
 # Official SoundTouch Web API Verification

docs/content/docs/appendix/PARITY-IMPROVEMENTS.md

@@ -1,5 +1,7 @@
 ---
 title: "Parity Improvements"
+sidebar:
+  exclude: true
 ---
 
 ### Overview of Recent Improvements and Next Steps

docs/content/docs/appendix/PARITY-OPENCLOUDTOUCH.md

@@ -1,5 +1,7 @@
 ---
 title: "Parity Analysis: Bose-SoundTouch (Go) vs. OpenCloudTouch (Python)"
+sidebar:
+  exclude: true
 ---
 
 # Parity Analysis: Bose-SoundTouch (Go) vs. OpenCloudTouch (Python)

docs/content/docs/appendix/PARITY-SOUNDCORK.md

@@ -1,5 +1,7 @@
 ---
 title: "Parity Analysis: Bose-SoundTouch (Go) vs. SoundCork (Python)"
+sidebar:
+  exclude: true
 ---
 
 # Parity Analysis: Bose-SoundTouch (Go) vs. SoundCork (Python)

docs/content/docs/appendix/PRESET-QUICKSTART.md

@@ -1,5 +1,7 @@
 ---
 title: "Preset Management Quick Start Guide"
+sidebar:
+  exclude: true
 ---
 
 # Preset Management Quick Start Guide

docs/content/docs/appendix/PROJECT-PATTERNS.md

@@ -1,5 +1,7 @@
 ---
 title: "Project Structure Patterns: Bose SoundTouch API Client"
+sidebar:
+  exclude: true
 ---
 
 # Project Structure Patterns: Bose SoundTouch API Client

docs/content/docs/appendix/REQUEST_RECORDING_CONCEPT.md

@@ -1,5 +1,7 @@
 ---
 title: "Request Recording Concept"
+sidebar:
+  exclude: true
 ---
 
 # Request Recording Concept

docs/content/docs/appendix/SCMUDC-ENRICHMENT-IMPLEMENTATION.md

@@ -1,5 +1,7 @@
 ---
 title: "SCMUDC Enrichment Implementation Summary"
+sidebar:
+  exclude: true
 ---
 
 # SCMUDC Enrichment Implementation Summary

docs/content/docs/appendix/SERVICE-AVAILABILITY-IMPLEMENTATION.md

@@ -1,5 +1,7 @@
 ---
 title: "Service Availability Implementation Summary"
+sidebar:
+  exclude: true
 ---
 
 # Service Availability Implementation Summary

docs/content/docs/appendix/SOUNDTOUCH-SERVICE-ANNOUNCEMENT.md

@@ -1,5 +1,7 @@
 ---
 title: "🎉 Introducing SoundTouch Service: Local Cloud Service Emulation"
+sidebar:
+  exclude: true
 ---
 
 # 🎉 Introducing SoundTouch Service: Local Cloud Service Emulation

docs/content/docs/appendix/UNDOCUMENTED-COMMUNITY-FEATURES.md

@@ -1,5 +1,7 @@
 ---
 title: "Undocumented Community Features & API Discoveries"
+sidebar:
+  exclude: true
 ---
 
 # Undocumented Community Features & API Discoveries

docs/content/docs/appendix/UNIMPLEMENTED-ENDPOINTS.md

@@ -1,5 +1,7 @@
 ---
 title: "Unimplemented SoundTouch API Endpoints"
+sidebar:
+  exclude: true
 ---
 
 # Unimplemented SoundTouch API Endpoints

docs/content/docs/appendix/_index.md

@@ -0,0 +1,9 @@
+---
+title: "Appendix"
+weight: 99
+sidebar:
+  open: false
+---
+
+Internal design documents, implementation notes, and historical records.
+These are developer and maintainer references, not user guides.

docs/content/docs/appendix/device-lifecycle-and-power-on-enhancement.md

@@ -1,5 +1,7 @@
 ---
 title: "Device Lifecycle and /power_on Enhancement"
+sidebar:
+  exclude: true
 ---
 
 # Device Lifecycle and /power_on Enhancement

docs/content/docs/appendix/device-lifecycle-summary.md

@@ -1,5 +1,7 @@
 ---
 title: "Device Lifecycle Analysis - Executive Summary"
+sidebar:
+  exclude: true
 ---
 
 # Device Lifecycle Analysis - Executive Summary

docs/content/docs/appendix/power-on-implementation-guide.md

@@ -1,5 +1,7 @@
 ---
 title: "/power_on Implementation Guide"
+sidebar:
+  exclude: true
 ---
 
 # /power_on Implementation Guide

docs/content/docs/appendix/preset-store.md

@@ -1,5 +1,7 @@
 ---
 title: "SoundTouch `/storePreset` Implementation Guide"
+sidebar:
+  exclude: true
 ---
 
 # SoundTouch `/storePreset` Implementation Guide

docs/content/docs/appendix/scmudc-events-analysis.md

@@ -1,5 +1,7 @@
 ---
 title: "SCMUDC Events Analysis"
+sidebar:
+  exclude: true
 ---
 
 # SCMUDC Events Analysis

docs/content/docs/appendix/soundtouch-web-roadmap.md

@@ -1,5 +1,7 @@
 ---
 title: "soundtouch-web: remaining features"
+sidebar:
+  exclude: true
 ---
 
 # soundtouch-web: remaining features

docs/content/docs/appendix/stockholm-port-guide.md

@@ -1,5 +1,7 @@
 ---
 title: "Stockholm Backend — Port Guide for Bose-SoundTouch (Go)"
+sidebar:
+  exclude: true
 ---
 
 # Stockholm Backend — Port Guide for Bose-SoundTouch (Go)

docs/content/docs/architecture/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Architecture"
+weight: 5
+---

docs/content/docs/concepts/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Concepts"
+weight: 3
+---

docs/content/docs/guides/_index.md

@@ -0,0 +1,6 @@
+---
+title: "User Guides"
+weight: 1
+sidebar:
+  open: true
+---

docs/content/docs/reference/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Technical Reference"
+weight: 2
+---

docs/go.mod

@@ -1,3 +1,5 @@
 module github.com/gesellix/bose-soundtouch/docs
 
 go 1.22.0
+
+require github.com/imfing/hextra v0.12.3 // indirect

docs/go.sum

@@ -0,0 +1,2 @@
+github.com/imfing/hextra v0.12.3 h1:DZHY2rUWYteyzjlHi9r4n7Bb5e2Q+6LXe4C1Dqn0ZjM=
+github.com/imfing/hextra v0.12.3/go.mod h1:vi+yhpq8YPp/aghvJlNKVnJKcPJ/VyAEcfC1BSV9ARo=

docs/hugo.toml

@@ -4,6 +4,7 @@ title = "AfterTouch"
 
 enableRobotsTXT = true
 enableGitInfo = true
+disablePathToLower = true
 
 [module]
   [module.hugoVersion]
@@ -24,6 +25,14 @@ enableGitInfo = true
   displayUpdatedDate = true
   dateFormat = "January 2, 2006"
 
+  [params.search]
+    enable = true
+    type = "flexsearch"
+
+  [params.search.flexsearch]
+    index = "content"
+    tokenize = "forward"
+
   [params.navbar]
     displayTitle = true
     displayLogo = false

docs/layouts/_default/_markup/render-link.html

@@ -0,0 +1,18 @@
+{{- /*
+  Render hook: strip .md extension from internal links so that links
+  written as [foo](OTHER-PAGE.md) in Markdown source resolve to the
+  Hugo page URL instead of a raw .md path (which returns 404).
+
+  This replaces the jekyll-relative-links behaviour from the old Jekyll
+  site without requiring changes to any content files.
+*/ -}}
+{{- $dest := .Destination -}}
+{{- $isAbs := or (strings.HasPrefix $dest "http://") (strings.HasPrefix $dest "https://") (strings.HasPrefix $dest "//") -}}
+{{- if and (not $isAbs) (strings.HasSuffix $dest ".md") -}}
+  {{- $dest = strings.TrimSuffix ".md" $dest -}}
+{{- end -}}
+<a href="{{ $dest }}"
+  {{- with .Title }} title="{{ . }}"{{ end -}}
+  {{- if $isAbs }} target="_blank" rel="noopener noreferrer"{{ end -}}
+>{{ .Text | safeHTML }}</a>
+{{- /* Whitespace trimmed intentionally */ -}}