Skip to content

Commit a7415ef

Browse files
dem-extra1google-labs-jules[bot]d-morrison
authored
docs: improve narrative flow, definition notation, and pronoun clarity (#1118)
* docs: improve narrative flow, definition notation, and pronoun clarity - Add explicit noun phrases after demonstrative pronouns across subfiles. - Update mathematical definition equations to use \eqdef. Co-authored-by: dem-extra1 <112029334+dem-extra1@users.noreply.github.com> * docs: improve narrative flow, definition notation, and semantic line breaks - Add explicit noun phrases after demonstrative pronouns across subfiles. - Update mathematical definition equations to use \eqdef. - Enforce semantic line breaks on updated lines to satisfy check-new-line-breaks CI. Co-authored-by: dem-extra1 <112029334+dem-extra1@users.noreply.github.com> * docs: use the semantic estimator macro in def-estimated-risk-score Addresses optional finding 2 from the claude-review on PR #1118: collapse the hand-composed LHS into the single semantic macro that already exists for it. The reviewer suggested the \h... form; CLAUDE.md's "Estimator indirection" rule prefers the \e... family in new/touched content, so this uses \ehazfactorf. Both expand identically -- verified by rendering old and new side by side: old: \hat\theta_{{\lambda}}\mathopen{}\left(\tilde{x}\right) new: \hat{\theta_{{\lambda}}}\mathopen{}\left(\tilde{x}\right) The RHS \hvb is left alone: migrating it is a 43-site corpus-wide change, tracked as #1119. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com> --------- Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com> Co-authored-by: Douglas Ezra Morrison <demorrison@ucdavis.edu> Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com>
1 parent 93daad5 commit a7415ef

10 files changed

Lines changed: 11 additions & 10 deletions

_subfiles/Linear-models-overview/_exr-prac-linreg-score.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ $$
6868
\sum_{i=1}^n x_i y_i = \beta_0\sum_{i=1}^n x_i + \beta_1\sum_{i=1}^n x_i^2
6969
$$
7070

71-
These are the **normal equations**,
71+
These equations are the **normal equations**,
7272
whose solution gives the OLS/MLE estimators
7373
$\hat\beta_0$ and $\hat\beta_1$.
7474

_subfiles/Linear-models-overview/_sec_compare_lm_glm_deviance.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ $$
144144
= \sum_{k=1}^q \sum_{i: \vx_i = \vx_k} (y_i - \bar{y}_k)^2
145145
$$
146146

147-
This is nonzero whenever any covariate pattern has replicates with
147+
This within-group residual sum of squares is nonzero whenever any covariate pattern has replicates with
148148
different response values.
149149
The Gaussian deviance relative to the saturated model is therefore:
150150

_subfiles/Linear-models-overview/_sec_linreg_coef_sampling_dist.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ $$
2525

2626
:::{.notes}
2727

28-
These are all results you have hopefully seen before.
28+
These distribution properties are all results you have hopefully seen before.
2929

3030
:::
3131

_subfiles/Linear-models-overview/_sec_linreg_diag_conditional_resid.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ If our Gaussian linear regression model is correct, the residuals $\resid_i$ and
55
- a mean of 0
66
- a constant variance
77

8-
This should be true **for every** value of $x$.
8+
This mean and variance structure should be true **for every** value of $x$.
99

1010
---
1111

_subfiles/Linear-models-overview/_sec_linreg_diag_cooks_distance.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ the **Cook's distance** for observation $i$ is
1515

1616
$$
1717
D_i
18-
= \frac{\tp{(\hvb_{(-i)} - \hvb)}
18+
\eqdef \frac{\tp{(\hvb_{(-i)} - \hvb)}
1919
\tp{\mX}\mX
2020
(\hvb_{(-i)} - \hvb)}{p\,\hs^2}
2121
$$ {#eq-cooks-distance-def}

_subfiles/Linear-models-overview/_sec_linreg_diag_marginal_resid.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ rstandard(bw_lm2)
1818
```
1919

2020
::: notes
21-
These are nearly the same.
21+
These residual vectors are nearly identical.
2222
Any differences are from numerical rounding.
2323

2424
:::

_subfiles/glms/_sec_model_fitting_process.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ We will treat EDA as a "step 0" that precedes these four steps.
3636
> and are they nominal or ordinal?
3737
>
3838
> 2. What is the shape of the distribution?
39-
> This can be examined using frequency tables,
39+
> This shape can be examined using frequency tables,
4040
> dot plots,
4141
> histograms
4242
> and other graphical methods.

_subfiles/proportional-hazards-models/_def-estimated-risk-score.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,6 @@ After fitting the model,
88
we estimate it by the **estimated risk score**,
99
which substitutes the fitted coefficients $\hvb$ for $\vb$:
1010

11-
$$\hat\hazfactor\paren{\vx} = \expf{\dprod{\vx}{\hvb}}$$
11+
$$\ehazfactorf{\vx} \eqdef \expf{\dprod{\vx}{\hvb}}$$
1212

1313
:::

_subfiles/proportional-hazards-models/_def-risk-score.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ with coefficient vector $\vb$,
77
the **risk score** (also called the **hazard multiplier** or **partial hazard**)
88
for a subject with covariate vector $\vx$ is:
99

10-
$$\hazfactorf{\vx} = \expf{\reglincomb}$$
10+
$$\hazfactorf{\vx} \eqdef \expf{\reglincomb}$$
1111

1212
:::
1313

_subfiles/proportional-hazards-models/_sec_coxph-adjust_ties.qmd

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,8 @@ averages the results for the six possible orderings of the failures.
8383

8484
But we don't know the order they failed in, so instead of reducing the
8585
denominator by one risk coefficient each time, we reduce it by the same
86-
fraction. This is Efron's method.
86+
fraction.
87+
This fractional reduction approach is Efron's method.
8788

8889
::: smaller
8990
$$\left(\frac{\theta_1}{\theta_R+\theta_1+\theta_2+\theta_3}\right)

0 commit comments

Comments
 (0)