# Knowledge changelog — Explico Playground (Motion) The **knowledge version** of this study material: semver over the learning-facing content, independent of the `explico` engine version. The newest `## [x.y.z]` heading below must equal `about.version` in [`course.config.ts`](./course.config.ts) — a mismatch is a Tier-3 `knowledge-version-mismatch` warning at `pnpm validate:content`. Governance: [`docs/authoring/versioning.md`](../../docs/authoring/versioning.md), rules C1–C3. On every content change, add a bullet under `## [Unreleased]`; on a release, move it to a dated `## [x.y.z]` heading and bump `about.version` in the same commit. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). MAJOR = a lesson / competency / notation key removed or renamed, or a stated learning outcome changed. MINOR = a new lesson, section, notation entry, or assessment. PATCH = fixes, clarifications, sourcing, non-semantic notation edits. ## [Unreleased] ### Added - The projectile-range explorer has an angle-preset dropdown whose selected value and every choice render mathematical notation with the launch-angle explanation, while the existing slider still permits any intermediate angle. - Each lab (Newton's cannonball, the launch-angle and projectile-range explorers) has a "Reset to defaults" button after its inputs. The labs remember a reader's values across visits; the button brings back the values the figure was drawn with and forgets the saved ones. - Range Symmetry has a section, "Checking the pairs numerically": a short script that computes each angle's range and its complement's, its output as a downloadable table, a picture of two complementary launches, a figure of the steps from an angle to its partner, a common slip to avoid, and a two-item self-check before the checks. - Each chapter, each part and the whole course can be downloaded as a Word (`.docx`) document. ### Changed - PDFs and Word documents of every chapter, part and the whole course come in both Letter and A4; the Download menu's paper picker chooses between them. ### Fixed - Delimiters around ratios, signed quantities, angles, and other expressions that KaTeX renders taller now use scalable sizing, while ordinary function arguments remain concise under rule N15's height-based check. - The labs no longer bring back a stored slider value that is out of range or unreadable; they start from their default instead. - The launch-angle knowledge check typesets its answer choices as angles ($30^{\circ}$ … $90^{\circ}$) instead of spelled-out degrees. ## [1.0.0] - 2026-11-09 - The labs import `explico/components/figure/figure-state.ts` with its extension and `astro.config.mjs` imports the compiler without one, the specifiers the published package resolves, so the playground builds as a standalone course against `explico` from npm, not only inside this repository. - `motion.gravity` is a shared notation entry: the gravitational acceleration `g` was a page-local entry on two projectile chapters and a gloss on `motion.range`; one card now serves the range formula, Projectile Range and Newton's Cannonball, and it appears in the glossary. ### Added - The settings schema offers the multi-engine PDF and responsive EPUB export controls, including accessible-tagging and paper-size guidance for authors. - The "Position and coordinates" knowledge check asks three more questions: where a point with a given polar radius and angle lies, its $x$ coordinate from its polar coordinates, and which polar coordinates describe a point on the negative $y$ axis. The motion deck asks the five over two frames. - A custom 404 page plots the missing URL as a trajectory that cleanly misses its requested coordinate, then offers a route home and to the curriculum map. The playground supplies Astro's canonical site too, so its sitemap is built. - "Range Symmetry," a chapter without a slide edition, now follows "Projectile Range." It shows why complementary launch angles give the same range and ends with a new knowledge check. - "Projectile Range" has a deck, its slide edition (`projectile-range.deck.mdx`, served at `/projectiles/projectile-range/slides/`): the derivation from launch to landing in frames, the range formula recalled from the chapter, a step that sweeps the explorer's launch angle from $15^\circ$ to $75^\circ$, and the chapter's knowledge check as a question frame. - "The Optimal Launch Angle" has a deck too, served at its chapter's `slides/` address. It sweeps the range-vs-angle explorer from $15^\circ$ to $75^\circ$. - The "Motion in the plane" part has a deck of its own, the lecture of both its chapters (`motion/index.deck.mdx`, served at `/motion/slides/`): the slides of "Position and Coordinate Systems", then of "Velocity Under Constant Acceleration", each chapter a run of sections naming it, with each chapter's knowledge check as a question frame. The velocity frame recalls the first chapter's vector equation beside the second's. Neither chapter has a deck of its own: each one's slides icon in the sidebar, its "Slides for this chapter" link and its Download menu open its sections of the part's deck (`/motion/slides/#slide-2`, `#slide-17`). The part's page links the deck as "Slides for this part". - A new lesson taught as slides only, "Newton's Cannonball" (`projectiles/newtons-cannonball.deck.mdx`), closes the projectiles part: a cannon $100\ \text{km}$ up fires ever faster, in a new lab, until the ball falls around the Earth; the circular orbital speed $v_{1} = \sqrt{g\,R_{E}}$, the period of a low orbit, the escape speed and Newton's Moon test follow. It teaches the new competency `motion.explain-orbit`, with two new checks (`motion-orbit-speed-check`, `motion-moon-gravity-check`), cites the new source `newton-treatise-system-of-the-world`, and joins the playground track. - The landing page and the projectiles part's page name the new lesson. - `course.settings.schema.json` describes the `deck` settings (canvas, legend line, who sees the notes, the outcomes frame, the handout PDF), so the form editor offers them; the playground keeps their defaults. - Every chapter, each part and the whole course download as a tagged Typst PDF and Typst source, a tagged LuaLaTeX PDF, an untagged legacy pdfLaTeX PDF, and a reflowable EPUB 3 with native MathML. Every deck also downloads as tagged Typst slides and Typst source alongside its LaTeX PDF variants and source. The Download menu labels each engine explicitly. - Every chapter, each part and the whole course download as Markdown with their figures (`lessonExports.markdown` in `course.settings.json`). - The sidebar marks, for each reader, the chapters and part pages they have not opened yet and those that changed since they last opened them (`sidebarMarks` in `course.settings.json`). - The course asks each reader, once, whether it may remember their reading in their browser, and keeps nothing of it beyond the tab without a yes (`readingMemory` in `course.settings.json`); a chapter that changed since the reader last opened it says so under its title. - "Braking to a stop", the second worked example of "Velocity Under Constant Acceleration", tabulates the cyclist's velocity second by second — a plain table, which a worked example keeps out of the lesson's numbered tables. - "The Optimal Launch Angle" links the previous chapter, which derives the range equation; the link's tooltip names that chapter in full. - The "Projectile motion" part page recalls Part 1 with its symbols (acceleration, velocity, position), a citation, and a link to the kinematics summary table, each opening its card; "Motion in the plane" names its symbols the same way. The landing page's feature cards show a live symbol, the launch angle θ, and a table reference across chapters. - "Projectile Range" links ahead to the next chapter's range-vs-angle explorer, so the course has a reference to a figure on a later page. - Both labs draw their default plot at build time too (rule V3): the trajectory explorer and the range-vs-angle explorer show their plot before the page's scripts run, and a card for either figure, from any page, shows it. Each lab's plot options are one function its island and its wrapper share; `labs/still-plot.ts` draws them on a server-side document (`linkedom`, a new dev dependency). - "Projectile Range" names the flight angle φ, the angle of the projectile's velocity above the horizontal: it falls from the launch angle at launch to zero at the highest point and to the negative of the launch angle at landing. "Position and Coordinate Systems" draws its own polar angle φ the same way, so the course now has one letter with two page-local meanings: a card carried from one chapter to the other points at the other φ with a dashed arrow. `lint-ignore.yml` acknowledges the shared letter (`glyph-unique-in-corpus`). - A shared index entry, `motion.initial` (`{}_0`, "Initial value"), explains the subscript zero (explico rule N23). In "Position and Coordinate Systems", **v**₀ and **r**₀ each open one card for the whole symbol, "Velocity vector evaluated at t = 0" and "Position evaluated at t = 0", whose formula opens the velocity's or the position's own card. Before, they opened the velocity's and the position's card on the letter alone, and nothing explained the zero. The chapter introduces the entry where the subscript first appears. - "Projectile Range" declares the horizontal and the vertical component of a vector (`{}_x`, `{}_y`) and the two acceleration components (`a_x`, `a_y`) in `notation.local`. In the sampled flight data table, `v_x` and `v_y` open "Horizontal component of velocity" and "Vertical component of velocity", and a screen reader now tells the four component columns apart. The range derivation diagram's "components" step names `v_x` and `v_y`, with the same cards. ### Changed - The horizontal and the vertical coordinate, `coordinate-x` and `coordinate-y`, are shared notation entries now, no longer local to "Position and Coordinate Systems"; their keys are unchanged. In "Projectile Range", the sampled flight data table's `x` and `y` columns open them, where both opened the position vector's card, so a screen reader tells the two columns apart. The position's formula names them in place of its two glosses. - "Projectile Range" no longer wraps the velocity and acceleration components in `\explain{motion.velocity}{…}` or `\explain{motion.acceleration}{…}`: those cards describe the vector, not a component, and explico now reports such a wrap (`index-swallowed`). - The two labs name their symbols in the caption's live clause ("Shown for v₀ = …") as the lesson's own notation, each opening its card: `ProjectileRangePicture.astro` and `LaunchAnglePicture.astro` render them at build time and place the plots. - The landing page, both part pages, the glossary, the curriculum map and "Figures and tables" offer the HTML download and the print button too, not only the chapters. The settings schema's `lessonExports` descriptions say so; `course.settings.json` itself is unchanged. - `course.settings.json` sets the new `cards.carry` to `false`, explico's default: a reader turns "Carry cards" on with the switch beside their cards. The settings schema describes the `cards` block. ### Fixed - The velocity's and the acceleration's defining formulas write the differential upright, `\mathrm{d}`, as explico rule N2 asks; an italic `d` is a variable. - The settings schema's description of the About panel cites rules C2–C3; there is no C4. - "What changed in this material", in the About panel, and a changed page's "What changed" open this changelog where the site publishes it, `changelog.txt` beside the course (`astro build` copies it there); they named the file in a private repository, which no reader could open. ### Removed - `editorialStatus` from all 28 content files: the pages, notation entries, competencies, assessments, sources, the track and the abbreviation. explico no longer reads it, so the "draft" labels on the part pages, the notation cards, the glossary and the reference lists are gone. - The `conventions` block from `course.settings.json` and its schema. It named two placeholder entries (`motion.time`, `motion.predict-velocity`) for rule S5, which explico retired; no page changes. - The `glyph-unique-in-corpus:\varphi` line from `lint-ignore.yml`. It acknowledged nothing: both φ, the polar angle of "Position and Coordinate Systems" and the flight angle of "Projectile Range", are page-local `notation.local` entries, and the check counts only shared cards. No page changes. ## [0.9.0] - 2026-09-28 ### Added - A "Figures and tables" page (`figures-and-tables.mdx`, in the Reference group): every numbered figure, table and diagram of the course, by part and chapter, with its short caption. ### Changed - `course.settings.json` no longer sets `disclosure.diagrams`, which explico removed: a figure or a diagram no longer folds by itself. It sets `disclosure.folds` (closed) instead. - Float captions follow rule S9: every figure, table and diagram has a short caption, which opens its caption line, and the long caption goes on from it. New short captions: "Two points in both coordinate systems" (Table 1.1.1), "The two worked examples at a glance" (Table 1.2.1), "Polynomial values around the vertex" (Table 2.2.1). Rewritten long captions: Tables 1.1.1, 1.2.1, 2.1.1 and 2.2.1, Figures 2.1.1, 2.2.1 and 2.2.2, Diagrams 2.1.1 and 2.2.1. The two diagrams drawn by wrapper components take their captions from the lesson, so the "Figures and tables" page names them. - The two labs are laid out as LaTeX figures: the plot, then the caption, then the tools — an instruction line, the sliders with their number fields and, for the range, the live equation — in a tray a reader can fold. The caption ends with the case the plot shows ("Shown for v₀ = 20 m/s and θ = 30°: range 35.3 m, time of flight 2.04 s."), which replaces the result box. Each lab's discussion paragraph is now lesson text after its figure, and "Projectile Range"'s caption drops "for the chosen launch speed and launch angle" and its instruction sentence. A reference to either lab previews its plot. - "The Optimal Launch Angle" folds its dependency diagram away in a ``, whose bar names it. The diagram is now numbered and referenced: Diagram 2.2.1, "Inputs to the launch-angle search", cited from the opening paragraph. - "Projectile Range" cites a second source where the launch point is above the landing plane: OpenStax *College Physics 2e*, whose Example 3.5 solves the quadratic equation for the time of flight of a projectile that lands below its launch point (`content/sources/openstax-college-physics-2e.json`). - "Velocity Under Constant Acceleration" states its time origin as a note (`:::note[The time origin]`) instead of a numbered `[card=meta]` section: it is a convention of the course, not course logistics. "Velocity over time" is now § 1.2.1. - "Projectile Range" opens with a `## What this chapter uses [no-collapsible] [card=meta]` section around the paragraph that names the two results of Part 1 it builds on: prerequisites are course logistics, the meta tier. A meta section is unnumbered, so the chapter's section numbers do not change. ## [0.8.0] - 2026-09-27 ### Added - The two sets of worked examples are numbered and named by their topic: "Calculation examples between coordinate systems" is Example 1.1.1 in "Position and Coordinate Systems", and "Speeding up and braking at a constant acceleration" is Example 1.2.1 in "Velocity Under Constant Acceleration". The text after each set cites it by number, and pointing at the reference shows the set's title and its examples. "On this page" lists each set and each knowledge check. - Sections are numbered like a book's: "Two ways to name the same point" is § 1.1.2 — part 1, chapter 1, second section — and "From polar to Cartesian" under it is § 1.1.2.2. The number stands before each title on a wide screen and in print, and on a folded section at every width. The chain icon beside a title copies a link to that section and shows its number. The choices are the `numbering` block in `course.settings.json`, which states the engine's defaults. - Two sections now point at each other by number: "From Cartesian to polar" names § 1.1.2.2 for the conversion back, and "Velocity Under Constant Acceleration" names § 1.1.4.1, where the same integration is done for a vector. Pointing at either shows the section's title and first paragraph. - The course has a mark: an open book with its explanation rising out of it, in the site's accent green. It is the tab icon (`public/favicon.svg`, which follows the reader's light or dark theme), the home-screen icon (`public/apple-touch-icon.png`), the logo beside the title in the header, and the image on the landing page. Paths live in `course.settings.json` `branding`; nothing a reader reads has changed. - Two rules of the course's own, in `course.settings.json` `courseRules`, which exercise the engine's new `X` area: **X1** (enforced) — a paragraph never ends in a shout, so a paragraph ending in "Ni!" or "Eureka!" fails `pnpm validate:content`; and **X2** (a guide, switched off) — every fifth paragraph is four sentences in Object–Subject–Verb order, which no pattern can check and which the "Off" list therefore tells an agent not to apply. No lesson text changes: the corpus already complies with X1. - A notation card for the time derivative (`motion.time-derivative`), written as a dot over a letter. "Position and Coordinate Systems" now shows the velocity as $\mathbf{v}(t) = (\dot{x},\ \dot{y})$. Pointing at the dot shows the time-derivative card; pointing at the letter shows the coordinate's card. - "The Optimal Launch Angle" names the complementary launch angle $\theta' = 90^{\circ} - \theta$ and uses it to show that complementary angles give equal ranges. On this page the prime marks that angle, not a derivative; the page's notation list says so. ### Changed - A knowledge check and a set of worked examples now say what they are with a badge before their number, so their titles name only the topic. The checks are retitled: "Position and coordinates check" → "Position and coordinates", "Velocity check" → "Velocity under constant acceleration", "Range check" → "Projectile range", "Launch-angle check" → "Optimal launch angle". The "Try it" heading above each set of examples is gone, with its waiver: the set's own heading replaces it. On a narrow screen the check's number hides, as a section's does. - Nothing changes for readers. The build now checks the lessons' headings: each descends one level at a time (rule S6), and body content stands between two headings (rule S7). Every heading already passes S6. The one S7 finding is "Try it", straight above the worked examples, whose own title follows it at once, in both "Position and Coordinate Systems" and "Velocity Under Constant Acceleration". Each carries a waiver (`{/* explico-allow S7: … */}`) until the examples block names its own topic; "Try it" then goes. - Every collapse default is now in the `disclosure` block of `course.settings.json`, one entry per kind. Two change what a reader sees: worked examples start open, and a long table shows 8 rows when folded (4 from each end), so the sampled flight data in "Projectile Range" hides 3 rows, not 5. Knowledge checks, memos, figures and diagrams keep the state they had. - The memo in "The Optimal Launch Angle" folds like a section: its bar shows a chevron and, while folded, what it holds ("Hidden here: 2 paragraphs, 1 equation, 1 figure, 1 table"), and hovering it shows the start of it. Its link icon copies a link to it. - Every figure, diagram, table and memo is named by one caption, and a figure's or a diagram's number now stands in that caption line below it. Folding a figure or a diagram hides only its body: "Figure 2.1.1", the link icon and the caption stay on screen. The two explorers lose the names they carried inside: "Find the range-maximizing angle" above the launch-angle explorer, and the trajectory explorer's own line under its plot, whose sentence about the landing dot is now part of the figure's caption. The two diagrams have sentence captions ("The steps of the range derivation, from the launch conditions to the range"). - The memo in "The Optimal Launch Angle" is marked with a superscript *a* where it was a bracketed [1], so it no longer reads as a citation. Its bar now shows its caption, "Checking the polynomial vertex: its values on both sides of the vertex, and its downward-parabola shape". - The range formula in "Projectile Range" has a short caption, "Range formula": its reference preview is headed with it, and its copy button reads "Copy LaTeX — Range formula". The sampled flight-data table and the two explorers have short captions for their previews too. No wording in the lessons changed. - "Projectile Range" sets three passages apart. Its two assumptions (level ground, no air resistance) open "From launch to landing" as a note, and the sentence that the range equation holds only under them is a caution. The "Worked example: try it" section — the explorer and the prose around it — is one card. The words are unchanged. - "Velocity Under Constant Acceleration" shows its convention, "The time origin", as a grey panel that does not fold. The words are unchanged. - Boxes follow what they hold (the engine's container tiers). Figures and the trajectory explorer lose their box; the notation list, a part page's side panel and the About panel are grey; knowledge checks and worked examples are tinted cards with a shadow, and a knowledge check's title now sits inside its card; memos keep a left rule without a box around it. - Every equation, table, figure, diagram and knowledge-check number now names its chapter, and each chapter counts from 1: the velocity equation of "Velocity Under Constant Acceleration" is (1.2.1), where it was (1.8), and the trajectory figure of "Projectile Range" is Figure 2.1.1. A link to a numbered item still works; only the number shown changed. - Quantities in prose use unit symbols instead of spelled-out units (rule N9): "a time of 4 seconds" is now $4\ \text{s}$, "30 degrees above the horizontal" is $30^{\circ}$, and "$x = 3$ meters" is $x = 3\ \text{m}$ — in "Velocity Under Constant Acceleration", "Position and Coordinate Systems", and three knowledge-check prompts. The numbers and answers are unchanged. - Nothing changes for readers. The course's settings (title, description, About panel, parts, collapsible-section defaults, lesson exports) moved from `course.config.ts` and `astro.config.mjs` to `course.settings.json`, which VS Code opens as a form. The knowledge version stays in `course.config.ts`. - Nothing changes for readers. The projectile range lab now imports its slot helper from `explico/reference/lab-math-slot`, so the browser build no longer reaches the server-only KaTeX code. - The landing page's primary button now opens the overview of Part 1, "Motion in the plane". It used to open "Velocity Under Constant Acceleration", the second chapter, so a new reader skipped "Position and Coordinate Systems". The notation glossary button is gone, because the sidebar already links the glossary, and the curriculum map button is now styled as secondary. The tagline states the real size of the course (four chapters in two parts, not three lessons), and the tagline and the feature cards follow the prose rules P2–P9. - Every multi-step derivation is now one aligned chain (rule N18). "The Optimal Launch Angle" no longer spreads its polynomial argument over four displays that prose splits apart. It now has two chains: one rewrites the square of $\sin(\theta)\cos(\theta)$ as $u - u^{2}$, and one converts the vertex back to $\theta^{*} = 45^{\circ}$. The parabola argument stays in prose between them. The range formula in "Projectile Range" now shows its derivation step (horizontal velocity component multiplied by the time of flight, then the double-angle identity), and the worked examples in "Velocity Under Constant Acceleration" and "Position and Coordinate Systems" are chains too. The derivative definitions $\mathbf{v} = d\mathbf{r}/dt = (\ldots)$ and $\mathbf{a} = d\mathbf{v}/dt = d^{2}\mathbf{r}/dt^{2}$ stay on one line: N18 exempts a short chain that fits comfortably on one line. - All lesson text, part pages, knowledge checks, lab text, and notation cards were revised for the prose rules P2–P9. Each concept now has one term: "time of flight", not "time in the air" or "flight time"; "range", not "horizontal range"; "coordinate", not "component", for $x$ and $y$ of a position. The text also drops figurative and colloquial wording, and it has shorter sentences with stated logical links. Each display equation now has a lead-in sentence that says what it gives and where it comes from. - The `gravity` notation entry is now labelled "Gravitational acceleration", the same term as the $g$ gloss on the range entry. Its key is unchanged. - "Projectile Range": the "Flight telemetry" section is now "Sampled flight data", because the table is computed and not measured. The section on the optimal launch angle, "The angle pairs up", is now "Complementary launch angles give equal ranges". - The polynomial-shape figure in the memo on the optimal launch angle now labels five values on each axis (rule V6). - The "Projectile motion" part page now opens with a paragraph on how Part 1 leads into it: gravity gives a projectile a constant acceleration, so the velocity and position results of Part 1 apply to each component of its motion, and no new law of motion is needed. A second paragraph states what the part's two chapters cover. The "Motion in the plane" part page keeps its one paragraph, on what the part covers (rule S2). The course sets both paragraphs to 30–120 words in `course.settings.json` (`rules.S2`). ### Fixed - The acceleration notation card said acceleration is "one derivative below" position. It is the second time derivative of position. - The projectiles part page said the optimal launch angle comes from differentiating the range formula. The chapter uses the maximum of the sine and the symmetry of a parabola. Differentiation appears only in an optional aside. - "Projectile Range" said the course keeps the level-ground assumption "throughout". Its own next section drops that assumption. - The arctangent in the Cartesian-to-polar conversion now states the angle interval it returns and how to correct a point in the left half of the plane, instead of only saying that the quadrant must be checked. ## [0.7.0] - 2026-09-20 ### Added - An overview page for each of the two parts (`motion/index.mdx`, `projectiles/index.mdx`), so `/motion/` and `/projectiles/` are pages rather than 404s. Each says what its part is for and renders ``; the motion page also authors the `chain` that runs through its chapters. Neither page is a chapter: no competency, no knowledge check, no float numbers. - A `studyMinutes` estimate on all four chapters — one of them a single number rather than a range, so the corpus exercises both shapes — which the part pages and the landing page total. - A contents listing on the landing page (``), so the homepage reaches all four chapters instead of only the one its hero button names. ## [0.6.0] - 2026-09-19 ### Added - A "Launching from a height" section in the projectile-range lesson, with the range formula for a launch above the landing plane (`eq:range-from-height`) and a new `launch-height` notation entry. Its three nested scalable delimiter pairs around a radical are the corpus's example of engine-sized nesting (rule N17). ### Changed - Handed the two nested delimiter pairs in the optimal-launch-angle lesson back to `\left`/`\right`, replacing the hand-picked `\Bigl`/`\Bigr` sizes that rule N17 previously required. No mathematical content changed. ## [0.5.2] - 2026-09-18 ### Fixed - Resized the two nested delimiter pairs in the optimal-launch-angle lesson so each outer pair is visibly larger than the pair inside it (rule N17). No mathematical content changed. ## [0.5.1] - 2026-09-16 ### Fixed - Changed the temporary launch-angle substitution from $x$ to $u$ so $x$ retains its course-wide meaning as the horizontal coordinate. The existing page-local notation key is retained for compatibility; only its rendered glyph and the lesson's equations changed. ## [0.5.0] - 2026-09-14 ### Added - Enabled the native **Print / save as PDF** lesson action and its complete, chrome-free print layout. Printed lessons expand disclosures, tables, diagrams, and knowledge-check prompts while retaining current interactive visual results and restoring the reader's on-screen state afterward. ## [0.4.0] - 2026-09-14 ### Added - Enabled a fully self-contained HTML download for every lesson, with links back to the published playground whenever a reader leaves the downloaded lesson. - Replaced each lesson's duplicate “Check yourself”/assessment title pair with one numbered, referenceable assessment title and made the entire knowledge check a persistent collapsible section. “Velocity Under Constant Acceleration” now also demonstrates an inline knowledge-check reference. - Added two levels of optional detail to “The Optimal Launch Angle”: an inline calculus `ShortNote`, plus a later, numbered vertex-check memo cited from the main text and containing a referenceable equation, value table, and figure. - Added a nested launch-angle dependency diagram whose fixed-speed formula introduces shared notation from inside an Astro component. The example now integration-tests that component-only notation still receives a working page-scoped explanation card. - Numbered the "Projectile Range" derivation diagram independently from figures and gave its wide horizontal layout an in-page expand/shrink control plus a persistent title-driven minimize control; the mobile fallback now scrolls without detaching equations from their boxes. - Rewrote plain-text math notation as `$…$` LaTeX throughout "Position and Coordinate Systems", "Velocity Under Constant Acceleration", and "Projectile Range" — table headers, units, and inline quantities (`t`, `vx`, `\|v\|`, `45 m/s`) now render as real notation instead of plain characters, and hover for their notation cards like every other symbol on the page. A unit is `\text{}`-wrapped and folded into the same math span as its symbol (`$t\ \text{(s)}$`, not `$t$ (s)` or `$t$ (seconds)`) — the short abbreviation always, never the spelled-out word. New notation entries local to "Projectile Range" for the flight-telemetry table's specific kinetic/potential energy columns: `mass` (`m`), `kinetic-energy` (`\mathrm{KE}`), `potential-energy` (`\mathrm{PE}`) — the latter two were previously typeset correctly but had no hover card at all, and are now explicitly `\explain{}`-wrapped in the table header too (a bare `\mathrm{}` body can't auto-resolve the way a plain symbol does). A table header with no plain-language word next to its symbol now gets its accessible name generated automatically by a new build step (a visually-hidden label composed from the bound symbol's own notation card) instead of needing anything spelled out in the visible text — see the engine changelog's `rehype-table-header-labels.mjs` entry. Fixed a stale `units: radians` on "Position and Coordinate Systems"'s `polar-angle` card — every value it's actually shown in on that page (the table, the worked example) is degrees. - Rewrote every assessment `explanation` (and two `prompt`s) as `$…$` LaTeX, now that the engine renders them through KaTeX instead of showing raw text: "Range check", "Position and coordinates check", "Launch-angle check", and "Velocity check" all previously spelled their math out as plain characters (`v0^2 sin(2 theta) / g`, `sqrt(x^2 + y^2)`, `theta = 45 degrees`, …). Each explanation's trailing computed-value unit is folded into the same span, short form (`= 13\ \text{m/s}$.`, `= 5\ \text{m}$.`, `\approx 35.3\ \text{m}$.`), matching the table-header convention above; the full-sentence `prompt` word problems keep spelled-out units ("5 meters per second") since that's ordinary English prose, not a compact data label. - Applied new authoring rules N11–N13 (`docs/authoring/notation.md`) across the corpus. Parenthesized every bare trigonometric function — `\cos\varphi` / `\sin\theta` and similar in "Position and Coordinate Systems" and "The Optimal Launch Angle", `\sin\theta` in the "Projectile Range" derivation diagram — now a hard build error under N13. Worked-example substitution steps in "Velocity Under Constant Acceleration" and "Position and Coordinate Systems", and in the "Velocity check", "Range check", and "Position and coordinates check" assessment explanations, now carry units on every substituted value instead of only the final answer (N11). Dropped a handful of sentence-ending periods/commas that had been typed inside a `\text{}` unit label instead of the surrounding prose (N12). ## [0.3.0] - 2026-09-09 ### Added - New first lesson: **Position and Coordinate Systems** (`motion.position-and-coordinates`). It locates a moving point in the plane in both Cartesian and polar coordinates, converts between them, introduces velocity and acceleration as the first and second time derivatives of position, and closes on the constant-acceleration special case `r(t) = r_0 + v_0 t + a t^2 / 2` — the statement the rest of the course specialises. New competency `motion.describe-position` with its own knowledge check. - New page-local notation on that lesson: horizontal and vertical coordinate, polar radius, polar angle, and the velocity vector. ### Changed - The course is now organised into two **parts** — **Motion in the plane** (Position and Coordinate Systems, Constant Acceleration) and **Projectile motion** (Projectile Range, Optimal Launch Angle). Projectile Range and Optimal Launch Angle move from `/motion/` to `/projectiles/`. - **Every equation, table, and figure number changes.** They are now `‹part›.‹n›`, with `n` running across the whole part instead of restarting on each page: part 1 is (1.1) … (1.8) over its two chapters, part 2 opens at (2.1). Previously each lesson carried its own prefix. Every `[[eq-…]]` reference in the prose still resolves; nothing was hand-numbered. - **Position and Coordinate Systems** uses `###` subsections inside its `##` sections, so the material shows every structural level: part, chapter, section, subsection. - **Constant Acceleration** now names its scalar `v = v_0 + a t` as the one-dimensional reading of the new chapter-1 vector law, and links to it. - **Projectile Range** links to the chapter-1 position law it integrates, and to the polar-to-Cartesian conversion that turns "speed at an angle" into components. - Position, acceleration, and time are now introduced in **Position and Coordinate Systems** rather than in Constant Acceleration. - The **position** notation entry declares the bare glyph `\mathbf{r}` instead of the instantiated `\mathbf{r}(t)`, so `r`, `r(t)`, and `r_0` all resolve to the same card. - Every equation, table, and figure number shifts by one chapter: Constant Acceleration is now chapter 2, Projectile Range chapter 3, and Optimal Launch Angle chapter 4. - **Optimal Launch Angle** now defines `x = sin^2(theta)`, shows that formula in the `x` hover card, and displays the equivalent second-order polynomial `x(1 - x) = x - x^2` explicitly. - **Projectile Range** adds the launch-speed form `v_0 = sqrt(R g / sin(2 theta))`, exercising notation hover markers nested under a radical. ## [0.2.0] - 2026-09-06 ### Added - **Optimal Launch Angle** gains a second, calculus-free derivation — "A polynomial maximum, no calculus": rewriting `sin(2 theta)` shows range tracks `sin^2(theta) (1 - sin^2(theta))`, a downward parabola in `sin^2(theta)` with roots at 0 and 1, whose maximum sits halfway between them at `sin^2(theta) = 1/2`. New prerequisite: "knows a downward parabola takes its maximum halfway between its roots". - **Constant Acceleration** gains a second worked example ("Braking to a stop", a negative acceleration) and a summary `Table` (`tab-kinematics-summary`) comparing both scenarios side by side, referenced from the prose. - **Projectile Range**: the interactive explorer is now a numbered `Figure` (`fig-projectile-trajectory`) with a caption, and the worked example carries a same-page `[[eq-range]]` reference that highlights the equation when it is on screen and previews it when it is not. - New shared notation: **position** (`r = (x, y)`) and **acceleration** (`a = dv/dt`). Acceleration was a page-local term on Constant Acceleration; it is now a hoverable card everywhere. ### Changed - **Velocity** notation is now defined as the time derivative of position (`v = dr/dt`), with `v = v_0 + a t` as the constant-acceleration case, rather than presented only in the scalar form. Constant Acceleration gains a matching prerequisite: "familiar with the derivative as a rate of change". - Both motion explorers frame their charts in a fixed physical envelope for the chosen launch speed (apex height at 90°, maximum range at 45°) instead of rescaling the axes on every drag; Find the range-maximizing angle gets a launch-speed slider alongside the number field. ### Fixed - The projectile worked-example substitution shows the degree symbol inside the trig call (`sin(2 x 30°)`). - The range-derivation diagram flows left-to-right with inline (non-fraction) formulas that fit their boxes, and its `R` node resolves to the Range card. ## [0.1.0] - 2026-09-05 - First cut of the Motion course: three lessons — **Constant Acceleration** (predict velocity from `v = v_0 + a t`, with a derivation diagram and an interactive figure), **Projectile Range** (derive and compute `R = v_0^2 \sin(2\theta) / g` over level ground), and **Optimal Launch Angle** (show the range is maximised at 45°). - Shared notation for launch speed, launch angle, time, velocity, acceleration, range, and gravity; every rendered symbol resolves to a card. - Knowledge checks on each lesson; claims sourced to OpenStax *University Physics Vol. 1*, ch. 4. - Whole-course idealisation stated once: level ground, no air resistance, constant `g`.