upvote
Wow, I just can't agree with this take at all. The README is only 161 lines (very short for a git repo README!) and took me about 15 seconds to skim and decide whether or not it was interesting enough to keep the tab open.

Most of the project pages I have seen with videos either animate things at hyper-speed, meaning you can't actually follow is what happening, or drag on for minutes just to communicate something that I could have read in seconds. My time is more valuable than that.

Images are cool, however. We should do more of those.

reply
To that end, I've found it super easy to tell $LLM to make me a video showcasing the main features of whatever I'm building, have it write subtitles and give it a voice over. Obviously for a README a simple gif with burned in subtitles/annotations would be more useful.

Especially if the project is web-based it can just spin up playwright and record its actions.

reply