ADR-004: No local Quarto install

Status

Accepted

Context

Quarto requires a separate binary install (not pip-installable). The site is deployed via GitHub Pages.

Decision

Build and preview only via GitHub Actions. No local Quarto installation. Content is authored as .qmd (markdown) and .ipynb (notebooks), both of which are readable and editable without Quarto.

Consequences

  • Positive: Zero local tooling beyond Python and a text editor.
  • Positive: Build environment is fully defined in CI, so no “works on my machine” issues.
  • Negative: No local preview of the rendered site. Must push to see the result.
  • Negative: Slower feedback loop for layout/styling changes. Mitigated by Quarto’s predictable rendering of standard markdown.