Static assets
Every asset has one owner: a page-relative file, or a site-wide file under docs/public/.
Page-relative files
- install.md
- install.png
- schema.json
[Download the schema](./files/schema.json)Relative files follow the page, and docfuse check validates that references exist.
Public files
- logo.svg
- openapi.json
The public paths are /logo.svg and /files/openapi.json.
Use public/ for brand assets, shared downloads, and intentionally fixed public URLs. Do not keep the same file in both locations.
Before release, compress large images, remove secrets and internal addresses from screenshots, and choose stable download paths. Image, gallery, video, and audio behavior is consolidated in the Markdown Playground.