At build time all of the documents in the build are assembled inside the data variable. Metadata is added, stats are compiled, options are processed, and a final HTML document is emitted to the filesystem.

I think it might be useful of the scope of what constitutes a document was expanded to include all files involved in a build. The tree could come to include photographs, stylesheets etc

Why though?

avoid pop in.

Objects such as images and PDFs do present an interesting problem: how to attach a UUID to such objects in a way that is idempotent/reproducible, ideally without editing the files themselves.