AGENTS.md
Working conventions
- It is fine to run
quarto render as needed to verify changes.
- But prefer invoking
quarto render directly rather than wrapping multiple renders in shell loops or compound shell commands. That is, don’t do “files=(1-questions-and-data/labs/unvotes/lab_rubric.qmd 2-summarizing-data/labs/class-survey/lab_rubric.qmd 2-summarizing-data/labs/flights/lab_rubric.qmd); for f in $files;” and then just run quarto render of those files in the loop. And anytime you chain a quarto render command to another command with && just do the render first and then run the rest.
- Treat generated PDFs as build artifacts: do not edit them directly. Make changes to the source
.qmd files and regenerate the PDFs with Quarto.