# Rendered documents are Git-LFS objects, never raw blobs in the tree.
#
# `docs/*.pdf` is generated: `cargo xtask docs` for the books, `nornir docs
# export gunnar --config release/nornir.toml` for the front page. Each rebuild
# writes a whole new PDF, so committing them as ordinary blobs would put a
# megabyte of unrelated bytes into every docs commit and keep it there forever.
# LFS stores the pointer in the tree and the bytes out of the history.
#
# Smudge before rendering: typst embeds whatever bytes it is handed, so a
# pointer file left unsmudged is an image-shaped hole. `cargo xtask docs`
# refuses to render while any staged asset starts with the pointer magic.
docs/*.pdf filter=lfs diff=lfs merge=lfs -text