tax_smoothing_2#

  • Series: lecture-python-advanced.myst

  • File: lectures/tax_smoothing_2.md

  • Audit date: 2026-05-28

  • Categories audited: writing, math, code, figures, references, links, admonitions

  • Overall score: 6.6 / 10

  • Priority: MEDIUM

Score breakdown#

Category

Score

One-line note

Writing

8/10

Title in Title Case; subheadings sentence case; mostly one-sentence paragraphs.

Math

5/10

Bare E_0; {\cal N}; \textrm{...} mixed into a \sim definition.

Code

7/10

Spelled Greek (3); install cell with hide-output.

JAX

N/A

not a JAX lecture

Figures

6/10

1 ax.set_title; 3 figsize=; no :name: fields.

References

8/10

6 {cite} used; never {cite:t}.

Links

8/10

4 {doc} references; no raw cross-series URLs.

Admonitions

N/A

no exercises, solutions, or proof-family directives.

Issues#

Critical#

None found.

High severity#

None found.

Medium severity#

  • [qe-math-010 (proposed)] — Bare E_0 for expectation. Example: lectures/tax_smoothing_2.md:122. Count: ~3 occurrences.

  • [qe-math-011 (proposed)] — {\cal N} used as Normal distribution. Example: lectures/tax_smoothing_2.md:142. Count: 1 occurrence.

  • [qe-fig-003] — 1 ax.set_title occurrence.

Low severity#

  • [qe-writing-001] — A few longer paragraphs and bulleted lists with embedded narrative.

  • [qe-fig-005] — Figures lack :name: fig-... fields.

  • [qe-code-002] — Spelled Greek in code parameters.

Strengths#

  • \begin{bmatrix} used throughout (qe-math-003).

  • aligned (not align) inside $$ (qe-math-006) — e.g. L128.

  • Title in Title Case (qe-writing-006).

  • {doc} for cross-series references (qe-link-002).

  • Install cell at top with hide-output (qe-code-003).