Challenge Author

Focus on graph databases and graph technologies.

• Build graph structures hands-on - Import nodes, create relationships, configure properties as graph-native activities
• Use graph terminology - Nodes, relationships, properties (teach the graph model)
• Make it fun and practical - Challenges should be engaging and build toward something that works
• Deliver working results - Each challenge completes a building block that demonstrates value

Challenge lessons should:

• Guide learners through hands-on graph building tasks
• Reference graph concepts taught in previous lessons
• Validate graph structure (node counts, relationship patterns)
• Focus on what they're building, not what they're migrating from
• Result in something that works and can be queried

Phase 1: Understand Challenge (5 min)

Checklist: Gather Information

• Read WORKSHOP-PLAN.md for challenge objectives
• Read source course lesson(s) identified
• Read previous concept lesson (what was just taught)
• Identify what learners will build/import/create
• Note building block this challenge completes
• Understand verification criteria (what to check)

Key Questions to Answer

Before writing anything, answer:

1. What will learners build? (e.g., import Product nodes, create relationships)
2. What was just taught? (previous concept lesson)
3. What building block does this complete? (e.g., "Products exist in graph" ✓)
4. How do we verify success? (what verify.cypher should check)
5. What data are they using? (CSV files, configuration)
6. What tools are they using? (Data Importer, Query tool, etc.)

Read These Files

MUST READ:
- WORKSHOP-PLAN.md (for challenge details)
- Source course lesson (for challenge content)
- Previous concept lesson (for context)
- CONTENT_GUIDELINES.md (for style rules)

REFERENCE:
- modules/2-foundation/lessons/4-import-products/ (example challenge)
- verify.cypher, solution.cypher, questions/verify.adoc examples

Phase 2: Plan Challenge Structure (10 min)

Checklist: Challenge Outline

• Clear challenge statement upfront
• Data table showing CSV structure
• Download button for data files
• Reference to tool mechanics (Module 1 Lesson 3)
• Step-by-step instructions
• Property configuration details
• Snapshot option for skip-ahead
• Verification criteria defined

Structure Template

Introduction
├── Challenge statement: "You will [action]"
└── Building block: "This completes [description]"

The Data
├── CSV structure table
└── Download button

Tool Reference
└── "See Module 1 Lesson 3 for tool mechanics"

Instructions
├── Step 1: [What to do]
├── Step 2: [What to do]
└── Step N: [What to do]

Configuration Details
└── Property mapping table

Snapshot Option
└── Collapsible with pre-built model

Verification
└── Include questions/verify.adoc

Building Block Marker

Every challenge MUST complete a building block. State it clearly:

This completes **Building Block 1**: "Products exist in the graph" ✓

Examples:

• Module 2: "Products exist in the graph" ✓
• Module 3: "Customer→Order path complete" ✓
• Module 4: "Customer→Order→Product path complete" ✓

Phase 3: Write Challenge Introduction (5 min)

Checklist: Opening

• Clear challenge statement
• States what will be built
• References building block completion
• 2-3 sentences max (concise!)

Opening Pattern

[.slide.discrete]
== Challenge

You will [specific action with tool].

This completes **Building Block [N]**: "[Description]" ✓

Example:

[.slide.discrete]
== Challenge

You will use Data Importer to import Product nodes from a CSV file.

This completes **Building Block 1**: "Products exist in the graph" ✓

Phase 4: Write Data Section (10 min)

Checklist: Data Information

• Shows CSV structure in table format
• Explains what each column represents
• Uses [options="header"] AsciiDoc table
• Download button with correct file path
• Note about downloading once, using throughout

Data Table Pattern

[.slide]
== The Data

[Brief description of what the data represents]

[options="header"]
|===
| Column | Type | Description

| columnName1 | String | What this column contains
| columnName2 | Integer | What this column contains
| columnName3 | Float | What this column contains
|===

Example:

[.slide]
== The Data

The products.csv file contains information about items in the Northwind catalog.

[options="header"]
|===
| Column | Type | Description

| productId | String | Unique identifier for each product
| productName | String | Display name of the product
| unitPrice | Float | Price per unit in USD
| unitsInStock | Integer | Current inventory count
| categoryId | String | Reference to product category
|===

Download Button Pattern

[.slide]
== Load Data Files