Write workshop and module overviews
Purpose: Write workshop and module overview lessons.
When to use: Workshop needs an overview lesson (always first lesson) or module needs an overview (module.adoc).
Prerequisites:
This skill writes overview lessons for:
Do NOT write concept lessons, challenges, or practice lessons. This skill focuses ONLY on overviews.
Focus on graph databases and graph technologies.
Workshop overview pattern:
Before writing anything, answer:
MUST READ:
- WORKSHOP-PLAN.md (for workshop structure)
- CONTENT_GUIDELINES.md (for style rules)
- HOW-TO-BUILD-WORKSHOPS.md (for methodology)
REFERENCE:
- modules/1-aura-setup/lessons/1-workshop-overview/lesson.adoc
Introduction
└── States THE GOAL immediately
What You'll Build
├── Concrete deliverable
└── What it demonstrates
Module Progression
├── Module 1: [Transformation]
├── Module 2: [Transformation]
├── Module 3: [Transformation]
└── Module N: [Final integration]
Prerequisites
└── Required knowledge/tools
Duration
├── Core path: X hours
└── With optional: Y hours
Why This Matters
└── Value proposition (factual, not sales)
Summary
└── Call to action: "Ready? Let's go →"
= Workshop Overview: [What They'll Build]
:type: lesson
:order: 1
// Source: Adapted from [course-name]/[lesson]
[.slide.discrete]
== Introduction
In this workshop, you will [concrete action and deliverable].
[.slide]
== The Goal
By the end of this workshop, you will have built [concrete deliverable].
[Explain what this demonstrates or enables]
[.slide]
== What You'll Learn
This workshop guides you through [X] modules:
**Module 1: [Name]**
* [What you'll do]
* [Building block completion]
**Module 2: [Name]**
* [What you'll do]
* [Building block completion]
**Module 3: [Name]**
* [What you'll do]
* [Building block completion]
**Module N: [Name]**
* [What you'll do]
* [Building block completion]
[.slide]
== Prerequisites
To complete this workshop, you should have:
* [Prerequisite 1]
* [Prerequisite 2]
* [Prerequisite 3]
**Tools needed:**
* [Tool 1] - [Why]
* [Tool 2] - [Why]
[.slide]
== Duration
**Core path:** [X] hours
* All required lessons
* Essential concepts and challenges
**With optional lessons:** [Y] hours
* Additional practice exercises
* Deeper exploration of concepts
**Pace yourself:**
* Take breaks between modules
* Optional lessons can be completed as homework
[.slide]
== Why [This Approach]?
[Factual value proposition - NOT sales language]
[Specific benefits:]
* [Benefit 1 with concrete example]
* [Benefit 2 with concrete example]
* [Benefit 3 with concrete example]
[.summary]
== Summary
In this workshop, you will:
* [Outcome 1]
* [Outcome 2]
* [Outcome 3]
**Time commitment:** [X] hours core, [Y] hours with optional lessons
Ready to get started?