Skip to content

Autodoc: missing integration with the cache system #15864

@kristoff-it

Description

@kristoff-it

Today autodoc just happily places all its artifacts at the destination and calls it a day.

If you run zig test foo.zig -femit-docs, the cache system should be able to notice that the tests don't need to be re-run (it already does that), but that the doc files in the destination folder (docs/ by default) need to be replaced with a cached copy in case they're missing / stale.

Right now users will experience intermittent malfunctioning if they try to generate autodocs from zig test and other similarly cacheable commands.

This requires integrating autodoc correctly with the compiler caching system.

Metadata

Metadata

Assignees

Labels

autodocThe web application for interactive documentation and generation of its assets.bugObserved behavior contradicts documented or intended behaviorenhancementSolving this issue will likely involve adding new logic or components to the codebase.

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions