How an artifact is made: from brief to published image
A short illustrated walkthrough of how a platform artifact goes from brief to published image, with an FAQ and a comparison against hand-made images.
2 min read By Platform Documentation Guide #Publishing

An artifact in four panels
An artifact is any file the platform produces or stores for an article: an image, a captioned panel, a PDF. Each one is created from a written brief, measured against the site's visual rules, and stored under the article's own request id, so it can always be traced back to the decision that produced it.




The four steps
First, the brief is read and split into image slots. Second, several candidate images are generated for each slot. Third, each candidate is measured: contrast, palette and legibility are checked by deterministic tools, and those measurements outrank a model's opinion when the two disagree. Fourth, the best candidate is stored under the article and referenced by its public address. An article can only point at images stored this way.
Download this article as a PDF
A print-ready copy of this walkthrough, with all four panels, the FAQ and the comparison table.