Skip to content

Add Grammar chapter: relative & demonstrative pronouns (closes #26, #27, #8) - #33

Merged
d-morrison merged 5 commits into
mainfrom
claude/grammar-pronouns
Jun 20, 2026
Merged

Add Grammar chapter: relative & demonstrative pronouns (closes #26, #27, #8)#33
d-morrison merged 5 commits into
mainfrom
claude/grammar-pronouns

Conversation

@d-morrison

@d-morrison d-morrison commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a new Grammar chapter covering three open grammar issues about pronouns. New grammar.qmd with modular grammar/ include files, registered in _quarto.yml between word choice and conciseness.

Content

Relative pronouns (grammar/relative-pronouns.qmd)

  • Restrictive vs. non-restrictive: that vs. which (explain that vs which #26) — that for restrictive clauses (no comma), which for non-restrictive clauses (set off by commas), with worked examples and a quick drop-the-clause test.
  • Don't omit relative pronouns (don't omit relative pronouns #27) — keep that/which/who even when grammar permits dropping them, using the issue's own "methodological groundwork that I now apply to enteric fever" example.

Demonstrative pronouns (grammar/demonstrative-pronouns.qmd) (#8)

  • Don't leave this/that standing alone as a pronoun; name the referent ("This overfitting poses a problem" rather than "This poses a problem"). (The Texas A&M demonstratives guide cited in the issue 404s/403s and fails the lychee link-checker, so it was dropped in 7131a6a; the worked example carries the point on its own.)

Conventions followed

  • AI-assistance disclaimer include after the chapter heading.
  • Quarto #exm- example environments (not bold labels), per copilot-instructions.md.
  • Modular section includes; semantic line breaks; blank lines before lists (relative/demonstrative pronoun members are now bullet lists per the CLAUDE.md 3+ item rule).
  • Verified with quarto render --to html — renders as chapter 6 with examples 6.1–6.4 numbered and cross-referenceable.

Closes

Closes #26, Closes #27, Closes #8.

🤖 Generated with Claude Code

claude added 3 commits June 18, 2026 19:24
New `grammar.qmd` chapter (with modular `grammar/` include files) covering:

- Relative pronouns: restrictive *that* vs. non-restrictive *which*, and
  keeping the relative pronoun rather than omitting it.
- Demonstrative pronouns: name the referent instead of using a bare
  *this*/*that* as a standalone pronoun.

Follows the established chapter conventions (AI-assistance disclaimer
include, Quarto `#exm-` example environments, modular section includes)
and registers the chapter in _quarto.yml between word-choice and conciseness.
Verified with `quarto render --to html`.

Closes #26, #27, #8.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018v7h9ZVVQRBjdyRFGXCrzG
The Texas A&M demonstratives guide URL (carried over from issue #8)
returns 404 — the page has moved — which failed the lychee link-checker.
The chapter's example already makes the point, and the other chapters cite
no external grammar guides, so drop the link rather than chase a
bot-blocked replacement.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018v7h9ZVVQRBjdyRFGXCrzG
… layout

main restructured the project from a Quarto `book` into the website-profile
layout (PR #28): content pages moved under `chapters/`, the chapter list moved
out of `_quarto.yml` (now `profile: default: website`) into the
`_quarto-website.yml` navbar, and pages now carry per-format front matter.

Resolved the `_quarto.yml` conflict by taking main's profile-based config, and
adapted the new Grammar chapter to the website layout:

- Moved `grammar.qmd` -> `chapters/grammar.qmd` and `grammar/` ->
  `chapters/grammar/` (include partials).
- Replaced the `# Grammar` book heading with website-style front matter
  (`title:` + html/revealjs/pdf/docx `output-file` stems), matching the other
  chapters.
- Registered "Grammar" in the `_quarto-website.yml` navbar between Word choice
  and Conciseness, and excluded `chapters/grammar/` from direct render (it holds
  include partials only), mirroring `chapters/defining-terms/`.
- Added "overfit" to `inst/WORDLIST` for the spell-check.

Verified with `quarto render chapters/grammar.qmd --to html` (examples 6.x
render and cross-reference) and a local `spelling` pass.
@d-morrison d-morrison closed this Jun 18, 2026
@d-morrison d-morrison reopened this Jun 18, 2026
@claude

claude Bot commented Jun 18, 2026

Copy link
Copy Markdown

Claude finished @d-morrison's task in 3m 52s —— View job


Code Review: PR #33 — Grammar chapter (relative & demonstrative pronouns)

  • Gather context (read changed files)
  • Review _quarto-website.yml changes
  • Review chapters/grammar.qmd
  • Review chapters/grammar/relative-pronouns.qmd
  • Review chapters/grammar/demonstrative-pronouns.qmd
  • Review inst/WORDLIST
  • Post inline findings
  • Write summary verdict

Overall verdict

The chapter is clean and well-structured. Front matter stems are consistent (grammar-slides.html, grammar-handout.pdf, grammar.docx), the #exm- environments are correctly formed, the navbar entry and !chapters/grammar/ render exclusion are both in place, WORDLIST is alphabetical, and no build artifacts are committed. Four minor issues flagged as inline comments:

# File Finding
1 chapters/grammar/relative-pronouns.qmd:2 5-item comma-separated list in parentheses — CLAUDE.md style rule requires bullet lists for 3+ items
2 chapters/grammar/demonstrative-pronouns.qmd:2 4-item inline list — same rule; should be treated consistently with finding #1
3 chapters/grammar/demonstrative-pronouns.qmd:29 PR description mentions linking the Texas A&M demonstratives guide, but no link appears in the file
4 inst/WORDLIST:2 overfitting (gerund) also appears in the example text — likely in the system dictionary but worth noting if CI spell-check fails

Findings #1 and #2 are debatable: these are parenthetical enumerations embedded in a sentence, not standalone lists, so there's a reasonable argument they're a deliberate exception to the bullet-list rule. Finding #3 is the most concrete omission — the link was described in the PR but not implemented.


To kick off a follow-up fix run:

@claude address review comments in [this review](https://github.com/d-morrison/psw/pull/33)

Comment thread chapters/grammar/relative-pronouns.qmd Outdated
Comment thread chapters/grammar/demonstrative-pronouns.qmd Outdated
Comment thread chapters/grammar/demonstrative-pronouns.qmd
Comment thread inst/WORDLIST
Address review feedback on #33. CLAUDE.md asks for bullet lists rather
than comma-separated prose when enumerating 3+ items. The chapter
introductions listed the relative pronouns (5 items) and the
demonstrative words (4 items) as inline parentheticals; pull each into a
bullet list so the chapter follows its own style rule.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DumtSMxBrkiC5c3fnxBwYu
@claude

claude Bot commented Jun 20, 2026

Copy link
Copy Markdown

Claude finished @d-morrison's task in 1m 56s —— View job


Review of updated PR #33

Checked all four findings from the prior review against the current branch state.


Finding #1 — Relative pronouns enumeration (bullet list)

Resolved. chapters/grammar/relative-pronouns.qmd lines 1–8 now use a proper bullet list with a blank line above, fully compliant with the CLAUDE.md style rule.

Finding #2 — Demonstrative pronouns enumeration (bullet list)

Resolved. chapters/grammar/demonstrative-pronouns.qmd lines 1–7 now use a proper bullet list with a blank line above.

Finding #3 — Missing Texas A&M demonstratives link

Resolved by removal. Commit 7131a6a removed the link with the message: "The Texas A&M demonstratives guide URL … returns 404 — the page has moved — which failed the lychee link-checker. … drop the link rather than chase a bot-blocked replacement." This is exactly the right call per CLAUDE.md's "fix broken links rather than adding exceptions" policy.

Finding #4overfitting in WORDLIST

Still not added, but likely fine. The word overfitting appears at demonstrative-pronouns.qmd:28 and is not in inst/WORDLIST. overfit (past-tense verb) is. overfitting is a common technical term that aspell's English dictionary almost certainly knows, so CI spell-check should pass. If it fails, add overfitting to inst/WORDLIST in alphabetical order (between overfit and whatever follows).


Overall verdict

All actionable findings are resolved. The chapter is clean: bullet lists compliant, dead link properly removed, navbar entry and render exclusions in place, #exm- environments correctly formed, front-matter stems consistent, no build artifacts. Ready to merge once CI is green.

@d-morrison
d-morrison merged commit a3e327e into main Jun 20, 2026
15 checks passed
@d-morrison
d-morrison deleted the claude/grammar-pronouns branch June 20, 2026 06:54
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-06-20 06:56 UTC

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.

don't omit relative pronouns explain that vs which no demonstrative pronouns

2 participants