From b0a9d7fdcc6a79e0f64fd53c16e4be99c0ca99c8 Mon Sep 17 00:00:00 2001
From: AJ Isaacs <ajisaacs27@gmail.com>
Date: Thu, 5 Feb 2026 23:17:53 -0500
Subject: [PATCH] docs: Add descriptive intro text to index pages

Adds brief explanatory paragraphs to Jobs, Materials, and Stock index
pages to help users understand each section's purpose.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 CutList.Web/Components/Pages/Jobs/Index.razor      | 5 +++++
 CutList.Web/Components/Pages/Materials/Index.razor | 5 +++++
 CutList.Web/Components/Pages/Stock/Index.razor     | 5 +++++
 3 files changed, 15 insertions(+)

diff --git a/CutList.Web/Components/Pages/Jobs/Index.razor b/CutList.Web/Components/Pages/Jobs/Index.razor
index 816186f..bb6ed96 100644
--- a/CutList.Web/Components/Pages/Jobs/Index.razor
+++ b/CutList.Web/Components/Pages/Jobs/Index.razor
@@ -18,6 +18,11 @@
     </div>
 </div>
 
+<p class="text-muted mb-4">
+    Jobs organize the parts you need to cut for a project. Add parts with their required lengths and quantities,
+    assign stock materials, then run the optimizer to generate an efficient cut list that minimizes waste.
+</p>
+
 @if (loading)
 {
     <p><em>Loading...</em></p>
diff --git a/CutList.Web/Components/Pages/Materials/Index.razor b/CutList.Web/Components/Pages/Materials/Index.razor
index 7b7ae0a..6230959 100644
--- a/CutList.Web/Components/Pages/Materials/Index.razor
+++ b/CutList.Web/Components/Pages/Materials/Index.razor
@@ -9,6 +9,11 @@
     <a href="materials/new" class="btn btn-primary">Add Material</a>
 </div>
 
+<p class="text-muted mb-4">
+    Manage your material catalog here. Materials define the types of stock you work with — shape, size, type, and
+    grade. Once added, materials can be assigned to jobs and used to generate optimized cut lists.
+</p>
+
 @if (loading)
 {
     <p><em>Loading...</em></p>
diff --git a/CutList.Web/Components/Pages/Stock/Index.razor b/CutList.Web/Components/Pages/Stock/Index.razor
index 40fb751..674ff7a 100644
--- a/CutList.Web/Components/Pages/Stock/Index.razor
+++ b/CutList.Web/Components/Pages/Stock/Index.razor
@@ -11,6 +11,11 @@
     <a href="stock/new" class="btn btn-primary">Add Stock Item</a>
 </div>
 
+<p class="text-muted mb-4">
+    Stock items represent the specific lengths of material you have available for cutting. Each stock item links
+    a material to a length and tracks how many pieces you have on hand.
+</p>
+
 @if (loading)
 {
     <p><em>Loading...</em></p>