# Pass log — ell-gap-disaster

Story: `data/stories/answers.ts` → `"ell-gap-disaster"`

---

## PASS 1 — Editor (2026-05-29)

### WHAT I CHANGED

- **Headline is the right finding** (32-point within-school gap) but
  the prose was structured as a numbered checklist. Reworked into
  narrative form, leading with what the finding means before the
  exact numbers.

- **The "disaster" framing in the story id** is editorial. Can't change
  the id, but the prose should not lean into it — "disaster" is the
  kind of intensifier the style guide flags. The story title can stay,
  but the body should describe the gap factually.

- **Section title "Top 15 worst within-school ELL math gaps"** — "worst"
  is editorial. Replaced with "largest."

- **The discussion of mechanisms in "Reading the gap honestly"** runs
  long. Each candidate explanation gets a sentence; the section
  doesn't need four-paragraph treatment.

### LEGAL REVIEW NOTES

- Naming PS 95 Gravesend as the school with the largest within-school
  ELL gap is fact, supported by the data. The framing should be
  descriptive (the gap exists at this school) rather than evaluative
  (this school fails ELL students).
- "ELL kids in good schools may be getting worse math instruction than
  their peers" is the kind of claim that could draw a response. Soften
  to: "ELL students at the same campuses score 60-85 points lower —
  for reasons the data alone can't separate."

---

## PASS 2 — Education expert (2026-05-29)

### WHAT I VERIFIED OR CORRECTED

- **PS 95 Gravesend** (Brooklyn District 21) — Bensonhurst/Gravesend
  area, heavy Chinese, Russian, and Italian immigrant enrollment.
  The within-school gap reflects a particular dynamic: a high-scoring
  never-ELL middle-class population alongside a recent-immigrant
  ELL cohort with very limited English on entry.

- **District 30 (Astoria/LIC) leading the gap by district** is
  consistent with the demographic mix there — significant
  middle-class/wealthy zoning alongside heavy recent-immigrant
  enrollment (Greek, South Asian, Latin American).

- **NYC ENL/bilingual policy context**: NYC's bilingual programs
  have been contracting since ~2010, replaced by "ENL" (English as a
  New Language) pull-out / push-in instruction. The reduction in
  bilingual program availability is part of the policy backdrop and
  worth noting.

- **NYS Spanish-language assessment (NYSITELL/NYSESLAT)**: the story
  references these. NYSESLAT measures English proficiency, not
  content knowledge in Spanish. NYC does not administer the math
  test in Spanish at scale. Verified.

- **"Years-of-ELL-status" framing**: NYC tracks ELL status as
  current ELL (years 1-6 of services), former ELL (exited services
  in past 4 years), and never ELL. The story should clarify that
  "current ELL" averages across years 1-6 — a year-1 arriver and a
  year-5 long-term ELL are different populations.

### WHAT I ADDED

- Context on PS 95 Gravesend's specific demographic mix.
- Brief note on the NYC ENL vs bilingual program landscape.
- Clarification on what "current ELL" actually covers (years 1-6
  bundled).

---

## PASS 3 — Quantitative (2026-05-29)

### WHAT I VERIFIED

- **31.7-point within-school average gap**: verified across 310
  schools. The math holds.
- **The 49.8-point ELA gap vs 31.7-point math gap**: verified.
  Math-ELA gap differential is roughly +18 points, consistent with
  the language-burden-on-the-test framing.
- **District 30 average gap of 45.4 points** across 22 schools:
  verified.

### WHAT I CORRECTED OR QUALIFIED

- **The 310-school sample is systematically larger than median NYC
  schools**: subgroup cell suppression below ~5 students means small
  schools drop out of the gap analysis. The 310 schools are mostly
  medium-to-large. This biases the gap analysis toward schools where
  both subgroups exist in measurable numbers, which is not the same
  as "all NYC schools."

- **"Current ELL" bundles years 1-6**: a year-1 student and a year-5
  student are at very different points on the language curve.
  Aggregating them attenuates the effect of time-in-services.

- **PS 122 Mamie Fay** at 72.2-point gap (0% ELL proficient) — note
  that "0%" with a small ELL cohort means a single high-scoring
  student would have moved that number materially. The displayed
  precision is misleading at very small cell sizes.

### WHAT I FLAGGED FOR DOWNSTREAM

- **Editor (pass 4):** Add a note that displayed precision on small
  cells can mislead. The 0% / 14% / 19% numbers reflect very small
  cohorts.

---

## PASS 4 — Editor (2026-05-29)

### WHAT I CHANGED

- Adopted the expert's PS 95 Gravesend demographic context.
- Adopted the "current ELL bundles years 1-6" clarification.
- Added a sentence on the sample selection bias (systematically
  larger schools) and the small-cell precision issue.
- The "Reading the gap honestly" section is now four short bullets
  instead of four paragraphs.

---

## PASS 5 — Education expert (2026-05-29)

### WHAT I VERIFIED OR CORRECTED

- Cross-checked: PS 748 Brooklyn Global Scholars (number 3 on the
  largest-gap list) — Sunset Park, dual-language school by name but
  in practice serves a four-way demographic mix. The within-school
  ELL gap here reflects that the dual-language program is one of
  several enrollment tracks at the school, not the whole student
  body.

- D30 specifically: Astoria/LIC has had rapid demographic change
  since ~2015 (gentrification + continued immigrant arrivals).
  Within-school gaps there reflect that pace of change.

---

## PASS 6 — Quantitative (2026-05-29)

### WHAT I VERIFIED

- All numbers still verified.

### WHAT I CORRECTED OR QUALIFIED

- Story now reads as quantitatively defensible. The small-cell-
  precision caveat is in.

---

## PASS 7 — Editor (final) (2026-05-29)

### WHAT I CHANGED

- Final polish: caption on the district-level bar chart now
  clarifies that the district average is across schools with both
  subgroups measurable (not all schools in the district).
- shortPreamble final sentence keeps the structural finding ("the
  gap is largest where the never-ELL population sits at the
  ceiling, not where the ELL population is uniquely struggling").

### KNOWLEDGE-FILE UPDATE

Added "Subgroup-gap stories systematically sample larger schools"
to `docs/agents/quantitative-knowledge.md`.

---

## FINAL STATUS

Story is publishable. Word delta: ~2100 → ~2200, gained context on
PS 95 Gravesend demographics, NYC ENL/bilingual policy backdrop,
sample-selection caveat.

---

## PASS 8 — Plain-language (2026-05-29)

### WHAT I CHANGED

- **"ELL" / "English Language Learner" / "current ELL" / "never-ELL"
  → human-readable phrasing throughout.** "Never needed English-
  language services" and "currently in English-language services"
  replaces every instance of the acronyms. Defined in the first
  sentence of shortPreamble: "English Language Learners — students
  who haven't yet reached fluency in English."

- **"Subgroup" → "group of students."**

- **"Cohort" → "group" / "students."**

- **"Cell" / "cell sizes" → "the number of students in the group"** +
  inline explanation of why small cells make exact percentages
  unreliable.

- **"Disaggregation" → "breakdown."**

- **"ENL" defined inline first use**: "the program is called English
  as a New Language, or ENL."

- **"NYSESLAT"** spelled out: "the NYSESLAT, the New York State test
  that measures students' English proficiency directly."

- **"D2 / D20 / D21 / D26 / D30 / D5 / D15"** → "District 2" /
  "District 20" / "District 21" etc., with neighborhood context inline
  ("District 30 in Astoria and Long Island City").

- **"Pull-out instruction"** kept but explained: "students learning
  English often receive separate language instruction… during
  portions of the school day — sometimes during the same period when
  other students are getting core math instruction."

- **Section headings** rewritten:
  - "Citywide ELL gap on grade-5 math (2024-25)" → "Citywide: a
    32-point gap in fifth-grade math"
  - "Gap trajectory over time" → "How the gap has moved over time"
  - "Math vs ELA: how much of the gap is the language of the test?" →
    "How much of the gap is the language of the test itself?"
  - "Top 15 largest within-school ELL math gaps" → "The 15 schools
    with the biggest gaps"
  - "Where the ELL gap is largest — by district" → "Which school
    districts have the biggest gaps"
  - "Where the gap is smallest — by admission type" → "Schools with
    selective admissions have smaller gaps"

- **Caveats block** fully rewritten in plain language.

### JARGON KILLED

- ELL / current ELL / never-ELL / former ELL (all replaced)
- subgroup / cohort
- cell / cell size
- disaggregation
- D-numbers for districts
- "Bensonhurst middle-class never-ELL population" → "long-established
  middle-class population alongside a more recent immigrant
  population just starting to learn English"

### ACRONYMS SPELLED OUT (first uses)

- ELL → English Language Learner (and replaced throughout)
- ENL → English as a New Language
- NYS → New York State
- NYSESLAT → with full clause "the NYSESLAT, the New York State test
  that measures students' English proficiency directly"
- NYC → New York City

### NEW PLAIN-LANGUAGE PATTERNS I'M ADDING TO THE KNOWLEDGE FILE

- "ELL" / "English Language Learner" → "students learning English"
  in flowing prose. In data labels: "currently in English-language
  services" / "never needed English-language services" — much
  longer but actually parseable.
- "Subgroup" almost never reads well — replace with "group of
  students" or just "students" with a modifier.
- District 5 / District 15 / District 30 etc. — always spell out
  "District," even in chart labels.
- "Cell sizes too small" → "when the number of students in the group
  is very small, a single student's score moves the percentage
  noticeably."

### WHAT I LEFT ALONE AND WHY

- School names.
- "NYSESLAT" (kept once with definition; it's the right citation for
  the recommended follow-up).
- "Bensonhurst" / "Astoria" / neighborhood names.
- "Composite (mixed selection)" — defined in the chart label;
  composite is the technical term but the parenthetical fixes it.

Net change: ~2200 → ~2600 words.
