AGENTS.md

Writing / Quarto math formatting

  • Use inline math with dollar signs: $...$ (not \(...\)).
  • Use display math with double dollar signs:
$$
...
$$

  • Do not use \[ ... \] for math blocks.

  • Do not use em-dashes (—).

  • Do not use hard line breaks in paragraphs. Let the text wrap naturally.

Publishing / OJS workflow

  • Before running quarto publish gh-pages, update local main with git fetch origin and git pull --ff-only origin main.
  • Publish from local main, not from a feature branch and not from a stale checkout.
  • If a post uses OJS / Observable cells, do not open the rendered HTML via file://.
  • Preview OJS pages with quarto preview or another local web server so the OJS runtime can load correctly.