Our docs agent keeps component pages in sync with the code, and the text is genuinely good now. The screenshots are another matter. Half of them show a version of the button from last year.
Has anyone got an agent to notice when a screenshot no longer matches what it is describing?
We stopped using screenshots for components and render the live component in the docs page instead. It sidesteps the problem.
We date every screenshot in the file name and the agent flags anything older than 90 days in the page it is editing. Crude, but it works.
Product marketing: same problem with sales decks. The agent updates the words and the screenshot shows last year's navigation.
Content producer, joined yesterday. For marketing pages we date every screenshot in the file name and have the agent flag anything older than 90 days. Crude, but it works.
Content design has the same trouble with help centre articles. The fix that stuck: the screenshot is owned by the feature team, the text by us.
The 90-day flag is what we do for blog images too.
Live components for the design system docs, the 90-day flag for everything else. Thanks both.