Skip to content

docs: editorial pass on README, write-up, and About bio#1

Merged
savvides merged 3 commits into
mainfrom
editorial-review
Apr 27, 2026
Merged

docs: editorial pass on README, write-up, and About bio#1
savvides merged 3 commits into
mainfrom
editorial-review

Conversation

@savvides
Copy link
Copy Markdown
Owner

@savvides savvides commented Apr 27, 2026

Summary

Editorial polish across the prose-heavy recent additions. Three commits, no code changes.

Commit 1 — first editorial pass (ba4b664)

  • README — Dropped the duplicate "An interactive data story" lead. Replaced a "fresh eyes" cliché in the 2026 Retrospective.
  • HOW-IT-WAS-MADE — Same "fresh eyes" cliché in the Realization section. Tightened "What I realized was that I didn't need to know..." → "I didn't need to know...".
  • index.html — Switched the About-Philippos footer bio from third person to first person to match the coda's voice.

Commit 2 — humanizer pass (b00a979)

  • README lead — Replaced the performative reveal "The answer was surprising:" with the answer itself, and trimmed "uncovered an ecological fallacy hiding in" to a plainer "the presence-learning correlation is an ecological fallacy."
  • README retrospective — Dropped "rock-solid" and the passive "could be made much stronger." Removed the "Key issues:" announcer.
  • HOW-IT-WAS-MADE realization — Removed the duplicated "hiding in" pattern and replaced "a genuine discovery, buried in an eight-year-old dataset" with "a real finding, eight years late."
  • About bio — Broke a rule-of-three list and replaced "My work looks at how" with a direct verb plus a doublet.

Commit 3 — bio removal (1f67113)

  • index.html — Replaced the inaccurate "About Philippos" bio paragraph with the author's name as the column heading. The LinkedIn link remains. Better an empty column than a wrong claim.

Documentation health

  • README.md — Updated (lead + retrospective)
  • HOW-IT-WAS-MADE.md — Updated (Realization + Process tightening)
  • index.html — Updated (footer About column)
  • CLAUDE.md — Current
  • CHANGELOG.md — Current (no new entry; matches prior convention for prose-only fixes)
  • VERSION — N/A (no VERSION file)

Test plan

  • Render the README on GitHub and read the lead from top to bottom — confirm the doubled "interactive data story" phrasing is gone and the answer ("They don't.") lands cleanly.
  • Open the deployed site, scroll to the footer, confirm the About column now shows just "Philippos Savvides" + LinkedIn.
  • Skim HOW-IT-WAS-MADE for any remaining clichés or run-on phrases.

🤖 Generated with Claude Code

- Drop the duplicate "An interactive data story" lead in README; the tagline
  already says it once.
- Replace two "fresh eyes" cliches (README retrospective, HOW-IT-WAS-MADE
  realization) with concrete language about going back to the data with
  newer statistical tools.
- Tighten "What I realized was that I didn't need to know..." to "I didn't
  need to know..." in HOW-IT-WAS-MADE.
- Switch the About-Philippos bio in the footer from third person to first
  person to match the rest of the site's voice.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refines the copy across several documentation files and the main index page, improving clarity and shifting the 'About' section to a first-person perspective. A review comment correctly identifies a technical inaccuracy in the README, suggesting the use of 'similar' instead of 'identical' to describe a small effect size (Cohen's d = 0.23) for better scientific precision.

Comment thread README.md Outdated
![The ecological fallacy reveal — dots colorized by condition show the overall correlation disappears within each group](docs/screenshot.png)

An interactive data story built from a 2018 PhD study (n=108) that tested whether VR headsets improve learning. The answer was surprising: the simulation matters, not the headsetVR and desktop produced identical outcomes (Cohen's d = 0.23) while both massively outperformed passive instruction (d > 2.4). A 2026 reanalysis uncovered an ecological fallacy hiding in the original results: a correlation that looked real at the group level vanished within each condition.
The 2018 PhD study (n=108) asked whether VR headsets improve learning. The answer was surprising: the simulation matters, not the headset. VR and desktop produced identical outcomes (Cohen's d = 0.23) while both massively outperformed passive instruction (d > 2.4). A 2026 reanalysis uncovered an ecological fallacy hiding in the original results a correlation that looked real at the group level vanished within each condition.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The term 'identical' is technically inaccurate when describing a Cohen's d of 0.23, which represents a small effect size rather than zero difference. Using 'similar' or 'comparable' would be more precise and scientifically accurate.

Suggested change
The 2018 PhD study (n=108) asked whether VR headsets improve learning. The answer was surprising: the simulation matters, not the headset. VR and desktop produced identical outcomes (Cohen's d = 0.23) while both massively outperformed passive instruction (d > 2.4). A 2026 reanalysis uncovered an ecological fallacy hiding in the original results — a correlation that looked real at the group level vanished within each condition.
The 2018 PhD study (n=108) asked whether VR headsets improve learning. The answer was surprising: the simulation matters, not the headset. VR and desktop produced similar outcomes (Cohen's d = 0.23) while both massively outperformed passive instruction (d > 2.4). A 2026 reanalysis uncovered an ecological fallacy hiding in the original results — a correlation that looked real at the group level vanished within each condition.

savvides and others added 2 commits April 27, 2026 13:51
- README lead: replace "The answer was surprising:" with the answer itself,
  and trim "uncovered an ecological fallacy hiding in" to "the presence-
  learning correlation is an ecological fallacy."
- README retrospective: drop "rock-solid" and the passive "could be made
  much stronger." Replace "Key issues:" announcer with a colon that
  introduces the list directly.
- HOW-IT-WAS-MADE Realization: drop the duplicate "hiding in" pattern;
  replace "a genuine discovery, buried in an eight-year-old dataset" with
  "a real finding, eight years late."
- About bio: break the rule-of-three "simulations, virtual environments,
  and emerging interfaces" and replace "My work looks at how" with a
  direct verb plus a doublet that has voice.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replace the column heading "About Philippos" with the author's name and
remove the bio paragraph. Better an empty column than a wrong claim.
LinkedIn link remains for readers who want more context.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@savvides savvides merged commit 44de73d into main Apr 27, 2026
0 of 2 checks passed
@savvides savvides deleted the editorial-review branch April 27, 2026 21:02
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.

1 participant