This message was deleted.

I do think that having one place with visual assets is nice. E.g. we have our demo video on the docs homepage

Fair.

I like them from the perspective of both the reader and writer of doc. sometimes a pictures says more than a thousand words. I don't like it, when the screenshots are out of date, or that they have to be maintained. Such a chore. In a perfect software project .... the screenshot url of the documentation would point to the output of an automated integration test of that feature that accesses it in a browser and then makes a screenshot as part of the test.

Sounds like something Openhands should be able to automate… Mamoodi happy to set it up if you want. Up to date images in projects would be a nice highlight of a win with the project. If the browser functionality doesn’t work a simple API call to an external service can do this in the meantime.