diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ecd5b2f..f1c3c95 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -158,10 +158,29 @@ Add edges in `data/{subject}-curriculum.json`:
## Add a new subject
-1. `data/catalog.json` — add to `subjects`.
-2. Create `data/{id}-curriculum.json` (copy structure from `math-curriculum.json`).
-3. Wire the subject in `themes/openfreebooks/templates/catalog.html` (until auto-wire lands).
-4. Add `content/{subject}/` when you have chapters.
+1. `data/catalog.json` — add the subject to `subjects`.
+2. Create `data/{id}-curriculum.json` (same schema as `math-curriculum.json`; `strands` + optional `graph.edges`).
+3. Add `content/{subject}/` when you have live chapters.
+4. Run `bun run build:js` (this syncs chapter content and auto-registers subject CSS/JS modules).
+
+### Subject scaffold (copyable)
+
+```text
+data/
+ {subject}-curriculum.json
+content/{subject}/
+ subject.scss # optional shared styles
+ subject.ts # optional shared JS init
+ {chapter-slug}/
+ _index.md # template = "chapter.html", extra.subject = "{subject}"
+ core.html # required
+ supplement.html # optional
+ chapter.scss # optional chapter-only styles
+ assets/ # optional
+ widgets/*.tsx # optional
+```
+
+No catalog/chapter template edits are required for new subjects when the subject is present in `data/catalog.json` and `data/{subject}-curriculum.json` exists.
---
diff --git a/README.md b/README.md
index 41f5905..180e7b7 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
# Open Free Books
+> Work in Progress. I am looking for contributors to help build this project. Educators welcome.
+
Free, open-source textbooks for every learner — from elementary school through university. The site is fully static, open on GitHub, and deployed to Cloudflare.
**Live site:** [openfreebooks.org](https://openfreebooks.org)
diff --git a/content/english/_index.md b/content/english/_index.md
new file mode 100644
index 0000000..06a4475
--- /dev/null
+++ b/content/english/_index.md
@@ -0,0 +1,5 @@
++++
+title = "English"
+description = "Browse English chapters in the curriculum catalog."
+sort_by = "weight"
++++
diff --git a/content/english/reading-comprehension-foundations/_index.md b/content/english/reading-comprehension-foundations/_index.md
new file mode 100644
index 0000000..8c70a27
--- /dev/null
+++ b/content/english/reading-comprehension-foundations/_index.md
@@ -0,0 +1,60 @@
++++
+title = "Reading comprehension foundations"
+description = "Find the main idea, key details, and evidence in short texts."
+template = "chapter.html"
+weight = 1
+[extra]
+subject = "english"
+chapter_id = "reading-comprehension-foundations"
+strand = "Reading & Writing Foundations"
++++
+
+
+
+ Reading comprehension means understanding what a text says directly and what it suggests
+ indirectly. In this chapter you will practice spotting the
+ main idea, finding
+ supporting details, and selecting
+ text evidence.
+
+
+
Main idea and key details
+
+ The main idea is the most important message in a paragraph or passage.
+ Key details are specific facts or examples that support that message.
+
+
+
+
Quick strategy
+
+ Ask: “If I had to summarize this paragraph in one sentence, what would I say?” Then check
+ which details in the text prove your sentence.
+
+
+
+
Use evidence, not guesses
+
+ Good answers point to exact words or phrases in the passage. You can quote directly or
+ paraphrase, but your answer should always connect back to the text.
+
+
+
+ Checkpoint: main idea
+
+
+ Read this sentence: “After weeks of practice, the choir finally sang in harmony during the
+ final rehearsal.” What is the main idea, and which words are the strongest evidence?
+
+
+
+
+ Checkpoint: evidence
+
+
+ A student writes: “The character is brave.” Improve this answer by adding one short quote
+ from the text and explaining how that quote proves bravery.
+
+
+
+
+ Reading comprehension means understanding what a text says directly and what it suggests
+ indirectly. In this chapter you will practice spotting the
+ main idea, finding
+ supporting details, and selecting
+ text evidence.
+
+
+
Main idea and key details
+
+ The main idea is the most important message in a paragraph or passage.
+ Key details are specific facts or examples that support that message.
+
+
+
+
Quick strategy
+
+ Ask: “If I had to summarize this paragraph in one sentence, what would I say?” Then check
+ which details in the text prove your sentence.
+
+
+
+
Use evidence, not guesses
+
+ Good answers point to exact words or phrases in the passage. You can quote directly or
+ paraphrase, but your answer should always connect back to the text.
+
+
+
+ Checkpoint: main idea
+
+
+ Read this sentence: “After weeks of practice, the choir finally sang in harmony during the
+ final rehearsal.” What is the main idea, and which words are the strongest evidence?
+
+
+
+
+ Checkpoint: evidence
+
+
+ A student writes: “The character is brave.” Improve this answer by adding one short quote
+ from the text and explaining how that quote proves bravery.
+
+
+
+
+ In HKDSE Physics, force and motion are linked by three core ideas:
+ inertia,
+ net force, and
+ acceleration. This chapter gives you one practical flow:
+ draw forces, find the net force, then predict acceleration with Newton's second law.
+
+
+
Newton's three laws
+
+ -
+ First law: if net force is zero, velocity stays constant (including rest).
+
+ -
+ Second law: acceleration is proportional to net force and inversely proportional
+ to mass.
+
+ -
+ Third law: forces come in equal and opposite interaction pairs.
+
+
+
+
+
+
Problem-solving workflow
+
+ - Choose one object as your system.
+ - Sketch all external forces in a free-body diagram.
+ - Resolve forces by direction and compute net force.
+ - Use \(a = F_{\text{net}} / m\), then connect to motion equations.
+
+
+
Interactive force lab
+
+ Adjust mass, pulling force, and surface friction. The demo computes friction, net force,
+ acceleration, and the motion state for a 3-second interval from rest.
+
+
+
Interactive motion graphs
+
+ Change initial velocity, acceleration, and elapsed time to inspect
+ v-t and s-t behavior.
+ This connects Newton's second law to kinematics directly.
+
+
+
Worked checkpoints
+
+ These quick prompts are designed for class discussion or self-check before moving to momentum
+ and energy.
+
+
+
+
+ A 4 kg trolley is pulled right with 18 N while friction is 10 N left. What is its acceleration?
+
+
+
+ Net force \(= 18 - 10 = 8\text{ N}\) to the right, so
+ \(a = F_{\text{net}}/m = 8/4 = 2\text{ m s}^{-2}\) to the right.
+
+
+
+
+
+ Why can a book stay at rest on a table even though gravity is acting?
+
+
+
+ Gravity pulls down, but the table exerts an equal normal force upward. Net force is zero, so
+ acceleration is zero.
+
+
+
+
+
+ A rocket pushes exhaust gas backward. Which Newton's law explains forward thrust?
+
+
+
+ Newton's third law. The rocket pushes gas backward; the gas pushes the rocket forward with an
+ equal and opposite force.
+
+
+
+
+
+ In the motion lab, what happens to the velocity-time line when acceleration is set to zero?
+
+
+
+ The line becomes horizontal, showing constant velocity. Position then changes linearly with
+ time.
+
+
+
+
+ In HKDSE Physics, force and motion are linked by three core ideas:
+ inertia,
+ net force, and
+ acceleration. This chapter gives you one practical flow:
+ draw forces, find the net force, then predict acceleration with Newton's second law.
+
+
+
Newton's three laws
+
+ -
+ First law: if net force is zero, velocity stays constant (including rest).
+
+ -
+ Second law: acceleration is proportional to net force and inversely proportional
+ to mass.
+
+ -
+ Third law: forces come in equal and opposite interaction pairs.
+
+
+
+
+
+
Problem-solving workflow
+
+ - Choose one object as your system.
+ - Sketch all external forces in a free-body diagram.
+ - Resolve forces by direction and compute net force.
+ - Use \(a = F_{\text{net}} / m\), then connect to motion equations.
+
+
+
Interactive force lab
+
+ Adjust mass, pulling force, and surface friction. The demo computes friction, net force,
+ acceleration, and the motion state for a 3-second interval from rest.
+
+
+
Interactive motion graphs
+
+ Change initial velocity, acceleration, and elapsed time to inspect
+ v-t and s-t behavior.
+ This connects Newton's second law to kinematics directly.
+
+
+
Worked checkpoints
+
+ These quick prompts are designed for class discussion or self-check before moving to momentum
+ and energy.
+
+
+
+
+ A 4 kg trolley is pulled right with 18 N while friction is 10 N left. What is its acceleration?
+
+
+
+ Net force \(= 18 - 10 = 8\text{ N}\) to the right, so
+ \(a = F_{\text{net}}/m = 8/4 = 2\text{ m s}^{-2}\) to the right.
+
+
+
+
+
+ Why can a book stay at rest on a table even though gravity is acting?
+
+
+
+ Gravity pulls down, but the table exerts an equal normal force upward. Net force is zero, so
+ acceleration is zero.
+
+
+
+
+
+ A rocket pushes exhaust gas backward. Which Newton's law explains forward thrust?
+
+
+
+ Newton's third law. The rocket pushes gas backward; the gas pushes the rocket forward with an
+ equal and opposite force.
+
+
+
+
+
+ In the motion lab, what happens to the velocity-time line when acceleration is set to zero?
+
+
+
+ The line becomes horizontal, showing constant velocity. Position then changes linearly with
+ time.
+
+
+
diff --git a/themes/openfreebooks/templates/partials/contributing-content.html b/themes/openfreebooks/templates/partials/contributing-content.html
index d222bbe..bb637ec 100644
--- a/themes/openfreebooks/templates/partials/contributing-content.html
+++ b/themes/openfreebooks/templates/partials/contributing-content.html
@@ -41,6 +41,7 @@ content/{subject}/{slug}/ → live page (one folder)
Compare (?view=compare, Mathematics only) — curricula comparison doc (HTML partial, not JSON).
Curriculum names (DSE, IB, …) appear only in the catalog, never inside lesson prose.
Every chapter needs a description (1–2 sentences; map clamps to three lines).
+ Adding a subject should only require updates in data/ and content/; templates stay unchanged.
@@ -77,7 +78,7 @@ content/{subject}/{slug}/ → live page (one folder)
2. Chapter folder
Add _index.md, core.html, optional supplement.html, assets/, widgets/*.tsx. Copy content/math/quadratic-equations/.
3. Build
- bun run build:js syncs HTML and bundles widgets — no theme or main.tsx edits.
+ bun run build:js syncs HTML and bundles widgets — no theme template or main.tsx edits.