TASK-C01: Course Information Architecture
- Status: Ready
- Scope Type: Documentation foundation
- Recommended Model Tier: Balanced
- Recommended Reasoning: Low to Medium
Objective
Create the newcomer training information architecture so the repo can support guided learning without losing the existing reference-doc structure.
Scope
- create
course,scenarios, andarchitectureentry sections - create a diagrams workflow page and folder conventions
- expose the new sections in VitePress nav and sidebar
- fix docs filename issues that block the docs build
- establish a reusable style and structure for course pages
Non-Scope
- writing the full training content for every module
- drawing all diagrams
- rewriting all existing lessons
Files To Read First
docs/index.mddocs/.vitepress/config.mtsdocs/implementation/ROADMAP.mddocs/requirements.mddocs/lessons/**only as needed to understand current coverage
Expected Deliverables
docs/course/index.mddocs/course/COURSE-ROADMAP.mddocs/course/COURSE-EXECUTION-GUIDE.mddocs/course/DIAGRAMS-WORKFLOW.md- new landing pages for scenarios and architecture
- nav and sidebar updates
Verification
npm run docs:build- manually confirm the new sections appear in nav and sidebar
Copy/Paste Prompt
text
You are working in C:\Lcn.Workspaces\lcn-wafer-inspection-desktop.
Audience: a newcomer software engineer or automation engineer learning this project.
Goal: turn this repo into a high-quality engineering training course, not just reference docs.
Style: practical, detailed, blog-quality English; clear headings; concrete examples; no fluff.
Ground all claims in the repo docs and code. Do not invent behavior that the current project does not support.
Prefer reusing and linking existing content under docs/lessons, docs/specs, docs/tasks, docs/adrs, docs/implementation, and the source code when helpful.
For diagrams, do not generate binary assets. Instead, produce a Draw.io-friendly diagram brief: title, purpose, nodes, edges, grouping, caption, and destination file path.
If you edit docs, keep VitePress navigation coherent and make sure npm run docs:build passes.
Task: Create the training-docs information architecture for this repo.
Read first:
- docs/index.md
- docs/.vitepress/config.mts
- docs/implementation/ROADMAP.md
- docs/requirements.md
- enough of docs/lessons to understand current topic coverage
Do:
- add top-level sections for Course, Scenarios, Architecture, and Diagrams workflow
- create landing pages for those sections
- create a concise course execution guide for model choice, prompting, and review
- fix filename or nav issues that block VitePress builds
- update VitePress nav and sidebar to expose the new sections
Do not:
- write the full course content yet
- rewrite all lesson pages
Verify:
- npm run docs:build
- confirm the new sections are visible in nav and sidebar