Skip to content

Index: state audience, prerequisites, and full outcome list - #45

Merged
thiagooak merged 1 commit into
mainfrom
ticket-37-index-prerequisites
Sep 21, 2026
Merged

thiagooak merged 1 commit into
mainfrom
ticket-37-index-prerequisites

Conversation

@thiagooak

Copy link
Copy Markdown
Owner

Summary

  • Splits the intro's SQL/Datalog comparison from the "what you'll be able to do" sentence, and expands the outcome list to include modeling, input parameters, pull, rules, and time travel, which the old one-liner omitted.
  • Adds a "Who this is for" section: no SQL required, a 5-item primer on reading Clojure data (vectors, keywords, logic variables, strings, comma-as-whitespace), a link to Clojure's reader reference, and a note that no Pokémon expertise is needed since domain terms are explained as they come up.

Verified the primer items and outcome list against actual chapter content (chapters.edn, each chapter's :h1, and grep for legendary/Special/generations usage) rather than assuming.

Out of scope: the ticket's suggested per-chapter "You will learn" bullets. That touches every chapter file, overlaps with other in-flight tickets, and is really its own follow-up (also referenced by PED-09's recap idea).

Closes #37

Test plan

  • clojure -X:test — 32 tests, 494 assertions, 0 failures

🤖 Generated with Claude Code

Readers had no signal that reading Clojure data was a prerequisite,
and the "you will learn" sentence omitted modeling, input params,
pull, rules, and time travel.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@thiagooak
thiagooak merged commit 85e93ce into main Sep 21, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PED-08: Audience, prerequisites and objectives are unstated

1 participant