docs: editorial pass on README, write-up, and About bio#1
Merged
Conversation
- 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>
There was a problem hiding this comment.
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.
|  | ||
|
|
||
| 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 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 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. |
There was a problem hiding this comment.
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. |
- 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Editorial polish across the prose-heavy recent additions. Three commits, no code changes.
Commit 1 — first editorial pass (
ba4b664)Commit 2 — humanizer pass (
b00a979)Commit 3 — bio removal (
1f67113)Documentation health
Test plan
🤖 Generated with Claude Code