Website build and deployment

Single build contract

• website/ is the only Quarto project.
• Quarto output publishes to docs/.
• pkgdown output publishes to docs/pkgdown/.
• Forbidden in-source outputs: website/docs/ and website/_site/.

Build script behavior

tools/build_docs.R renders Quarto and pkgdown, then syncs to published targets:

• Quarto -> docs/
• pkgdown -> docs/pkgdown/

Recommended checks before pushing

1. Run Rscript tools/build_docs.R.
2. Confirm docs/index.html and docs/pkgdown/index.html exist.
3. Run Rscript tools/site-map/run_site_map_checks.R --site-root=docs.
4. Ensure there are zero broken internal links and no legacy-page violations.

Prereqs

• Required packages and data for this page are listed in the setup chunks above.

Outputs

• This page renders model fits, diagnostics, and summary artifacts generated by package APIs.

Interpretation

• Canonical concept page: Spec And Contracts
• Treat this page as an application/example view and use the canonical page for core definitions.

Next

• Continue to the linked canonical concept page, then return for implementation-specific details.