[curriculum-eval] 15-conditional-logic.md: readability — FK grade level 6.2 and 4 callout blocks exceed thresholds

[github-actions]

File: workshop/15-conditional-logic.md
Overall Score: 8.12 / 10.0 (corpus mean: 8.80)

Flagged Dimensions:

Dimension	Score	Benchmark	Delta
readability	7.0	10.0 (FK grade 8–12)	-3.0
active_learning	4.8	10.0 (density ≥ 3.0/100 words)	-5.2
style_compliance	8.5	10.0 (≤ 3 callout blocks)	-1.5

Root Cause (≤ 2 sentences):
The Flesch-Kincaid grade level of 6.2 indicates extremely short, choppy sentences that fragment complex conditional logic concepts into too-brief statements — the opposite of the technical prose needed for developer learners (target FK 8–12). Four callout blocks (one over the 3-block limit) add visual interruption that breaks instructional flow, and the activity density of 1.45 means most content is still passive reading.

Evidence (quoted from the file):

The page uses 4 callout blocks across 688 words with an activity density of only 1.45; 20 new concepts are introduced (5 over the ceiling) with FK grade 6.2 — well below the 8–12 developer-education target.

Learning Science Rationale:
Mayer's Coherence Principle states that adding extraneous signals (excess callout blocks) hurts learning by diverting attention. Simultaneously, a FK grade of 6.2 in a developer workshop signals that sentences have been over-simplified to the point where complex conditional logic relationships cannot be expressed accurately — learners will fill in missing nuance incorrectly.

Improvement Prompt (for an agent):

In workshop/15-conditional-logic.md:
1. Consolidate the 4 callout blocks to at most 3. Merge any two callouts that cover related warnings, or convert one to inline prose.
2. Rewrite the shortest sentences (under 8 words) into fuller technical prose that explains the conditional logic relationships rather than just naming them. Target FK grade 8–10.
3. Add 1–2 hands-on exercises: e.g., "Add an if: expression to your existing workflow that skips the report step on weekends. Run it and confirm the step was skipped in the Actions log."
4. Move the 5 excess concepts (above the 15-concept ceiling) to the existing side-quest-15-01-expressions-and-contexts.md.

Expected Score After Fix: 8.9 / 10.0

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔬 Curriculum Quality Evaluator · 80.1 AIC · ⌖ 6.65 AIC · ⊞ 6.2K · ◷

• expires on Jul 22, 2026, 9:10 AM UTC