Merge pull request #23 from microsoft/docs/021-reorganization-execute

docs(021): execute docs folder reorganization

Author: codemonkeychris

README.md

@@ -298,11 +298,11 @@ dotnet run --project samples/apps/wordpuzzle
 
 | Doc | Description |
 |-----|-------------|
-| [Reactor pitch](docs/reactor-pitch.md) | The longer-form overview of what Reactor is and why |
+| [Reactor pitch](docs/pitch/reactor-pitch.md) | The longer-form overview of what Reactor is and why |
 | [Getting Started](src/Reactor/Docs/GettingStarted.md) | Tutorial — elements, layout, state, components |
 | [Architecture](src/Reactor/Docs/Architecture.md) | Virtual tree, reconciler, hooks, design decisions |
-| [Design Specs](docs/spec/) | Numbered specs covering theming, navigation, animation, data, accessibility |
-| [WinUI Integration Proposals](docs/winui3-integration-proposals.md) | 25 proposals for deeper platform integration |
+| [Design Specs](docs/specs/) | Numbered specs covering theming, navigation, animation, data, accessibility |
+| [WinUI Integration Proposals](docs/specs/proposals/winui3-integration.md) | 25 proposals for deeper platform integration |
 | [State & Hooks](docs/reference/state-and-hooks.md) | Deep dive on the hook system and reactivity |
 | [Reconciliation](docs/reference/reconciliation.md) | How tree diffing works (C# and Rust paths) |
 | [Native Differ](docs/reference/native-differ.md) | Rust differ architecture, FFI, experiments |

docs/README.md

@@ -0,0 +1,12 @@
+# Reactor Documentation
+
+- **[guide/](guide/)** — User-facing documentation. Getting started, topic guides, screenshots.
+- **[reference/](reference/)** — Architecture deep dives for framework contributors.
+- **[specs/](specs/)** — Design specs, implementation tasks, and proposals.
+- **[research/](research/)** — Competitive analysis, investigations, bug write-ups.
+- **[pitch/](pitch/)** — Marketing materials and design targets.
+- **[reports/](reports/)** — Point-in-time reports (work summaries, metrics).
+- **_pipeline/** — Internals of the doc-generation pipeline. Not reader-facing.
+
+The `guide/` folder is pre-rendered because screenshot capture requires a running
+WinUI host. To rebuild it locally, run `mur docs compile`.

docs/templates/ai-author-skill.md docs/_pipeline/ai-author-skill.mddocs/templates/ai-author-skill.md renamed to docs/_pipeline/ai-author-skill.md

@@ -8,12 +8,12 @@ must work with the `mur docs compile` pipeline.
 
 The doc system has two inputs and one output per topic:
 
-1. **Template** (`docs/templates/<topic>.md.dt`) — Markdown with YAML
+1. **Template** (`docs/_pipeline/templates/<topic>.md.dt`) — Markdown with YAML
    front-matter, snippet directives, screenshot references, and `ai:lock`
    sections.
-2. **Doc App** (`docs/apps/<topic>/`) — A compilable Reactor app containing
+2. **Doc App** (`docs/_pipeline/apps/<topic>/`) — A compilable Reactor app containing
    snippet-marked code and a `doc-manifest.yaml` for screenshots.
-3. **Output** (`docs/output/<topic>.md`) — Final compiled Markdown with
+3. **Output** (`docs/guide/<topic>.md`) — Final compiled Markdown with
    snippets inlined and screenshot paths resolved.
 
 You produce both the template and the doc app. The compile pipeline does the
@@ -28,7 +28,7 @@ rest.
 ```yaml
 ---
 title: "Human-readable title"
-app: <topic-id>            # matches the docs/apps/<topic-id>/ directory
+app: <topic-id>            # matches the docs/_pipeline/apps/<topic-id>/ directory
 order: 3                   # sort order in the final docset
 audience: beginner|intermediate|advanced
 goal: |
@@ -75,10 +75,10 @@ instructions.
 
 ## Doc App Structure
 
-Each topic has a companion app in `docs/apps/<topic>/`:
+Each topic has a companion app in `docs/_pipeline/apps/<topic>/`:
 
 ```
-docs/apps/my-topic/
+docs/_pipeline/apps/my-topic/
   my-topic.csproj          # Standard Reactor project
   App.cs                   # Main source with snippet markers
   doc-manifest.yaml        # App config + screenshot definitions
@@ -493,7 +493,7 @@ images, form labels, headings, landmarks, TabIndex gaps, etc.).
 
 ## Topic Ideas for the Full Docset
 
-Generate these as `<topic>.md.dt` + `docs/apps/<topic>/` pairs:
+Generate these as `<topic>.md.dt` + `docs/_pipeline/apps/<topic>/` pairs:
 
 ### Beginner
 

docs/apps/accessibility/App.cs docs/_pipeline/apps/accessibility/App.csdocs/apps/accessibility/App.cs renamed to docs/_pipeline/apps/accessibility/App.cs

@@ -17,10 +17,10 @@ class Tier1Demo : Component
     public override Element Render()
     {
         return VStack(12,
-            Factories.Text("Account Settings")
+            Text("Account Settings")
                 .FontSize(24).Bold()
                 .HeadingLevel(AutomationHeadingLevel.Level1),
-            Factories.Text("Profile")
+            Text("Profile")
                 .FontSize(18).SemiBold()
                 .HeadingLevel(AutomationHeadingLevel.Level2),
             TextField("", _ => { }, placeholder: "Display name")
@@ -47,13 +47,13 @@ public override Element Render()
                 .HelpText("Type a product name or SKU to filter results")
                 .Width(300),
             VStack(8,
-                Factories.Text("Revenue by Region").Bold(),
-                Factories.Text("Bar chart placeholder").Opacity(0.5)
+                Text("Revenue by Region").Bold(),
+                Text("Bar chart placeholder").Opacity(0.5)
             ).FullDescription(
                 "Bar chart showing Q1 revenue: East $4.2M, " +
                 "West $3.8M, Central $2.1M")
              .Padding(16).Background("#f5f5f5").CornerRadius(8),
-            Factories.Text("Decorative divider")
+            Text("Decorative divider")
                 .Opacity(0.2)
                 .AccessibilityHidden()
         ).Padding(24);
@@ -73,7 +73,7 @@ public override Element Render()
             && email.Contains('@') && agree;
 
         return VStack(12,
-            Factories.Text("Create Account").FontSize(24).Bold()
+            Text("Create Account").FontSize(24).Bold()
                 .HeadingLevel(AutomationHeadingLevel.Level1),
             TextField(name, setName, header: "Full Name")
                 .AutomationName("Full name").Required().TabIndex(1),
@@ -103,10 +103,10 @@ public override Element Render()
              .AutomationName("Main navigation"),
 
             VStack(12,
-                Factories.Text("Dashboard")
+                Text("Dashboard")
                     .FontSize(20).Bold()
                     .HeadingLevel(AutomationHeadingLevel.Level1),
-                Factories.Text("Welcome back. Here is your overview.")
+                Text("Welcome back. Here is your overview.")
             ).Landmark(AutomationLandmarkType.Main)
              .AutomationName("Main content"),
 
@@ -124,20 +124,20 @@ class HeadingHierarchyDemo : Component
     public override Element Render()
     {
         return VStack(12,
-            Factories.Text("Application Settings")
+            Text("Application Settings")
                 .FontSize(24).Bold()
                 .HeadingLevel(AutomationHeadingLevel.Level1),
-            Factories.Text("Appearance")
+            Text("Appearance")
                 .FontSize(18).SemiBold()
                 .HeadingLevel(AutomationHeadingLevel.Level2),
-            Factories.Text("Choose your preferred theme and font size."),
-            Factories.Text("Notifications")
+            Text("Choose your preferred theme and font size."),
+            Text("Notifications")
                 .FontSize(18).SemiBold()
                 .HeadingLevel(AutomationHeadingLevel.Level2),
-            Factories.Text("Email Alerts")
+            Text("Email Alerts")
                 .FontSize(15).SemiBold()
                 .HeadingLevel(AutomationHeadingLevel.Level3),
-            Factories.Text("Configure which emails you receive.")
+            Text("Configure which emails you receive.")
         ).Padding(24);
     }
 }
@@ -157,8 +157,8 @@ public override Element Render()
             When(showModal, () =>
                 Border(
                     VStack(12,
-                        Factories.Text("Modal Dialog").FontSize(18).Bold(),
-                        Factories.Text("Tab/Shift+Tab stays inside this panel."),
+                        Text("Modal Dialog").FontSize(18).Bold(),
+                        Text("Tab/Shift+Tab stays inside this panel."),
                         TextField("", _ => { }, placeholder: "Name")
                             .TabIndex(0),
                         Button("Close", () => setShowModal(false))
@@ -191,7 +191,7 @@ public override Element Render()
             }),
             Button("Error (Assertive)", () =>
                 announce.Announce("Connection lost!", assertive: true)),
-            Factories.Text($"Saves: {count}").Opacity(0.6),
+            Text($"Saves: {count}").Opacity(0.6),
             announce.Region  // invisible live region — must be in tree
         ).Padding(24);
     }
@@ -218,7 +218,7 @@ public override Element Render()
                 role: "slider",
                 value: $"{rating} of 5 stars",
                 rangeMin: 1, rangeMax: 5, rangeValue: rating),
-            Factories.Text($"Current: {rating}/5").Opacity(0.6)
+            Text($"Current: {rating}/5").Opacity(0.6)
         ).Padding(24);
     }
 }

…/apps/accessibility/accessibility.csproj …/apps/accessibility/accessibility.csprojdocs/apps/accessibility/accessibility.csproj renamed to docs/_pipeline/apps/accessibility/accessibility.csproj docs/apps/accessibility/accessibility.csproj renamed to docs/_pipeline/apps/accessibility/accessibility.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net9.0-windows10.0.22621.0</TargetFramework>
@@ -12,6 +12,6 @@
     <PackageReference Include="Microsoft.WindowsAppSDK" Version="$(WindowsAppSDKVersion)" />
   </ItemGroup>
   <ItemGroup>
-    <ProjectReference Include="..\..\..\src\Reactor\Reactor.csproj" />
+    <ProjectReference Include="..\..\..\..\src\Reactor\Reactor.csproj" />
   </ItemGroup>
 </Project>

docs/apps/accessibility/doc-manifest.yaml …ine/apps/accessibility/doc-manifest.yamldocs/apps/accessibility/doc-manifest.yaml renamed to docs/_pipeline/apps/accessibility/doc-manifest.yaml docs/apps/accessibility/doc-manifest.yaml renamed to docs/_pipeline/apps/accessibility/doc-manifest.yaml

@@ -22,9 +22,9 @@ public override Element Render()
             ErrorBoundary(
                 Component<BuggyComponent>(),
                 (Exception ex) => VStack(8,
-                    Factories.Text("Something went wrong").Bold()
+                    Text("Something went wrong").Bold()
                         .Foreground("#d13438"),
-                    Factories.Text(ex.Message).FontSize(12).Opacity(0.7)
+                    Text(ex.Message).FontSize(12).Opacity(0.7)
                 ).Padding(12)
                  .Background("#fde7e9")
                  .CornerRadius(8)
@@ -54,15 +54,15 @@ public override Element Render()
 
         return VStack(12,
             SubHeading("Memo"),
-            Factories.Text($"Parent renders: click count = {count}"),
+            Text($"Parent renders: click count = {count}"),
             Button("Increment", () => setCount(count + 1)),
             Memo(ctx =>
             {
                 // This subtree only re-renders when label changes
                 return Border(
                     VStack(4,
-                        Factories.Text($"Memoized: {label}").Bold(),
-                        Factories.Text("Skips re-render when deps unchanged")
+                        Text($"Memoized: {label}").Bold(),
+                        Text("Skips re-render when deps unchanged")
                             .FontSize(12).Opacity(0.6)
                     ).Padding(12)
                 ).Background("#f0f0f0").CornerRadius(8);
@@ -86,7 +86,7 @@ public override Element Render()
                         .SetToolTip(btn, "This is a native tooltip");
                     btn.Padding = new Thickness(20, 10, 20, 10);
                 }),
-            Factories.Text("Styled via .Set()")
+            Text("Styled via .Set()")
                 .Set(tb =>
                 {
                     tb.TextWrapping = TextWrapping.WrapWholeWords;
@@ -143,7 +143,7 @@ public override Element Render()
             ToggleSwitch(vm.DarkMode, v => vm.DarkMode = v,
                 header: "Dark Mode"),
             Slider(vm.FontSize, 10, 32, v => vm.FontSize = (int)v),
-            Factories.Text($"Preview: {vm.UserName}")
+            Text($"Preview: {vm.UserName}")
                 .FontSize(vm.FontSize).Bold()
         ).Padding(24);
     }
@@ -171,10 +171,10 @@ public override Element Render()
                     { _tasks.Add(input.Trim()); setInput(""); }
                 })
             ),
-            Factories.Text($"{tasks.Count} tasks:").SemiBold(),
+            Text($"{tasks.Count} tasks:").SemiBold(),
             VStack(4, tasks.Select((task, i) =>
                 HStack(8,
-                    Factories.Text($"{i + 1}. {task}"),
+                    Text($"{i + 1}. {task}"),
                     Button("Remove", () => _tasks.RemoveAt(i))
                 ).WithKey($"task-{i}-{task}")
             ).ToArray())

docs/apps/advanced/App.cs docs/_pipeline/apps/advanced/App.csdocs/apps/advanced/App.cs renamed to docs/_pipeline/apps/advanced/App.cs

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net9.0-windows10.0.22621.0</TargetFramework>
@@ -12,6 +12,6 @@
     <PackageReference Include="Microsoft.WindowsAppSDK" Version="$(WindowsAppSDKVersion)" />
   </ItemGroup>
   <ItemGroup>
-    <ProjectReference Include="..\..\..\src\Reactor\Reactor.csproj" />
+    <ProjectReference Include="..\..\..\..\src\Reactor\Reactor.csproj" />
   </ItemGroup>
 </Project>