Reorganize repository docs layout

Author: FolderView Plus Test

CONTRIBUTING.md .github/CONTRIBUTING.mdCONTRIBUTING.md renamed to .github/CONTRIBUTING.md

@@ -46,7 +46,7 @@ bash scripts/unraid_matrix_smoke.sh
 
 - Include a clear summary of what changed and why.
 - Include screenshots for UI changes (desktop and mobile when relevant).
-- Update docs (`README.md`, `CHANGELOG-fixes.md`, or language files) when behavior changes.
+- Update docs (`README.md`, `docs/CHANGELOG.md`, or language files) when behavior changes.
 - Keep backwards compatibility unless the change is intentional and documented.
 
 ## Coding Standards

SECURITY.md .github/SECURITY.mdSECURITY.md renamed to .github/SECURITY.md

@@ -57,11 +57,10 @@ jobs:
             docs:
               - 'README.md'
               - 'docs/**'
-              - 'CHANGELOG-fixes.md'
-              - 'CONTRIBUTING.md'
               - 'LICENSE.md'
-              - 'SECURITY.md'
-              - 'SUPPORT*.md'
+              - '.github/CONTRIBUTING.md'
+              - '.github/SECURITY.md'
+              - '.github/SUPPORT*.md'
               - 'src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/README.md'
             metadata:
               - 'folderview.plus.plg'

SUPPORT.md .github/SUPPORT.mdSUPPORT.md renamed to .github/SUPPORT.md

@@ -18,7 +18,7 @@
 FolderView Plus gives Unraid a cleaner, folder-first way to manage Docker containers, VMs, and Dashboard views.
 It is built for real libraries: easier organization, smarter setup, safer recovery, and clearer runtime diagnostics.
 
-Quick links: [Install](#install) | [What It Does](#what-it-does) | [Settings Overview](#settings-overview) | [Rules Quick Guide](#rules-quick-guide) | [Bulk Assignment Quick Guide](#bulk-assignment-quick-guide) | [Backups and Recovery](#backups-and-recovery) | [Troubleshooting](#troubleshooting) | [Theme Guide](docs/THEME_GUIDE.md) | [Support Policy](SUPPORT_POLICY.md)
+Quick links: [Install](#install) | [What It Does](#what-it-does) | [Settings Overview](#settings-overview) | [Rules Quick Guide](#rules-quick-guide) | [Bulk Assignment Quick Guide](#bulk-assignment-quick-guide) | [Backups and Recovery](#backups-and-recovery) | [Troubleshooting](#troubleshooting) | [Theme Guide](docs/THEME_GUIDE.md) | [Support Policy](docs/SUPPORT_POLICY.md) | [Docs Index](docs/README.md)
 
 ## Screenshots
 
@@ -343,7 +343,7 @@ File naming rules:
 
 Stable selector and migration policy:
 
-- [SUPPORT_POLICY.md](SUPPORT_POLICY.md)
+- [docs/SUPPORT_POLICY.md](docs/SUPPORT_POLICY.md)
 
 Recommended migration path:
 

.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+# FolderView Plus Docs
+
+This folder holds project documentation that does not need to stay at the repository root.
+
+## Core Docs
+
+- [CHANGELOG.md](CHANGELOG.md)
+- [SUPPORT_POLICY.md](SUPPORT_POLICY.md)
+- [THEME_GUIDE.md](THEME_GUIDE.md)
+- [THEME_API_CONTRACT.md](THEME_API_CONTRACT.md)
+
+## Architecture
+
+- [docker-runtime-architecture.md](docker-runtime-architecture.md)
+- [vm-runtime-architecture.md](vm-runtime-architecture.md)
+- [visual-runtime-contract.md](visual-runtime-contract.md)
+
+## Testing and Assets
+
+- [edge-cases-test-matrix.md](edge-cases-test-matrix.md)
+- [images/README.md](images/README.md)
+- [images/screenshots/README.md](images/screenshots/README.md)
+
+## Releases
+
+- Versioned release notes live in [`releases/`](releases/).

README.md

@@ -280,7 +280,7 @@ classify_changed_path_subsystems() {
   esac
 
   case "${changed}" in
-    README.md|docs/*|CHANGELOG-fixes.md|SECURITY.md|SUPPORT*.md|CONTRIBUTING.md|src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/README.md)
+    README.md|docs/*|.github/SECURITY.md|.github/SUPPORT*.md|.github/CONTRIBUTING.md|src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/README.md)
       printf '%s\n' "docs"
       return
       ;;

CHANGELOG-fixes.md docs/CHANGELOG.mdCHANGELOG-fixes.md renamed to docs/CHANGELOG.md

@@ -4,7 +4,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 
 const repoRoot = path.resolve(process.cwd());
-const supportPolicyPath = path.join(repoRoot, 'SUPPORT_POLICY.md');
+const supportPolicyPath = path.join(repoRoot, 'docs', 'SUPPORT_POLICY.md');
 const readmePath = path.join(repoRoot, 'README.md');
 
 const supportPolicy = fs.readFileSync(supportPolicyPath, 'utf8');
@@ -27,7 +27,7 @@ test('support policy documents selector contracts and deprecation window', () =>
 
 test('readme links to support policy from legacy migration section', () => {
     assert.match(readme, /Legacy CSS\/JS Migration \(FolderView2\/3\)/);
-    assert.match(readme, /SUPPORT_POLICY\.md/);
+    assert.match(readme, /docs\/SUPPORT_POLICY\.md/);
 });
 
 test('readme documents v2 support bundle preview and sanitized redaction defaults', () => {