docs: reorganize design and reqstream into system-name subfolders per…

… updated standards

Agent-Logs-Url: https://github.com/demaconsulting/NuGetCaching/sessions/ba1d0f14-2e46-4863-b2fc-bbaf9a23790a

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

.reviewmark.yaml

@@ -13,18 +13,18 @@ evidence-source:
   location: https://raw.githubusercontent.com/demaconsulting/NuGetCaching/reviews/index.json
 
 reviews:
-  - id: NuGetCaching-System
-    title: Review of NuGetCaching System Integration
+  - id: NuGetCaching-Architecture
+    title: Review of NuGetCaching System Architecture
     paths:
-      - "docs/reqstream/system.yaml"
+      - "docs/reqstream/nuget-caching/nuget-caching.yaml"
       - "docs/design/introduction.md"
-      - "docs/design/system.md"
+      - "docs/design/nuget-caching/nuget-caching.md"
 
   - id: NuGetCaching-Design
     title: Review of NuGetCaching Architecture and Design
     paths:
-      - "docs/reqstream/system.yaml"
-      - "docs/reqstream/platform-requirements.yaml"
+      - "docs/reqstream/nuget-caching/nuget-caching.yaml"
+      - "docs/reqstream/nuget-caching/platform-requirements.yaml"
       - "docs/design/**/*.md"
 
   - id: NuGetCaching-AllRequirements
@@ -36,15 +36,15 @@ reviews:
   - id: NuGetCaching-NuGetCache
     title: Review of NuGetCaching NuGetCache Unit
     paths:
-      - "docs/reqstream/nuget-cache.yaml"
-      - "docs/design/nuget-cache.md"
+      - "docs/reqstream/nuget-caching/nuget-cache.yaml"
+      - "docs/design/nuget-caching/nuget-cache.md"
       - "src/**/NuGetCache.cs"
       - "test/**/NuGetCacheTests.cs"
 
   - id: NuGetCaching-PathHelpers
     title: Review of NuGetCaching PathHelpers Unit
     paths:
-      - "docs/reqstream/path-helpers.yaml"
-      - "docs/design/path-helpers.md"
+      - "docs/reqstream/nuget-caching/path-helpers.yaml"
+      - "docs/design/nuget-caching/path-helpers.md"
       - "src/**/PathHelpers.cs"
       - "test/**/PathHelpersTests.cs"

docs/design/definition.yaml

@@ -5,9 +5,9 @@ resource-path:
 input-files:
   - docs/design/title.txt
   - docs/design/introduction.md
-  - docs/design/system.md
-  - docs/design/nuget-cache.md
-  - docs/design/path-helpers.md
+  - docs/design/nuget-caching/nuget-caching.md
+  - docs/design/nuget-caching/nuget-cache.md
+  - docs/design/nuget-caching/path-helpers.md
 template: template.html
 table-of-contents: true
 number-sections: true

docs/design/introduction.md

@@ -43,6 +43,17 @@ src/DemaConsulting.NuGet.Caching/
 └── PathHelpers.cs              — Safe path combination utilities (internal)
 ```
 
+Design documentation mirrors the software structure:
+
+```text
+docs/design/
+├── introduction.md             — Design overview and software structure
+└── nuget-caching/
+    ├── nuget-caching.md        — System-level design
+    ├── nuget-cache.md          — NuGetCache unit design
+    └── path-helpers.md         — PathHelpers unit design
+```
+
 Test code mirrors the source structure:
 
 ```text

requirements.yaml

@@ -20,10 +20,10 @@
 #   list below (unit files first, then platform, then ots in alphabetical order)
 
 includes:
-  - docs/reqstream/system.yaml
-  - docs/reqstream/nuget-cache.yaml
-  - docs/reqstream/path-helpers.yaml
-  - docs/reqstream/platform-requirements.yaml
+  - docs/reqstream/nuget-caching/nuget-caching.yaml
+  - docs/reqstream/nuget-caching/nuget-cache.yaml
+  - docs/reqstream/nuget-caching/path-helpers.yaml
+  - docs/reqstream/nuget-caching/platform-requirements.yaml
   - docs/reqstream/ots/buildmark.yaml
   - docs/reqstream/ots/mstest.yaml
   - docs/reqstream/ots/nuget.yaml