Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

+1. I do a lot of videos, especially now that COVID has put the kibosh on in-person conferences and everything is pre-recorded. I usually need 3 takes to do a decent talk recording and that assumes substantial prep to lay out the story line. Anything less is a meandering mess.

It's way easier just to write a decent README.md.



Why not both?


What does the video add that the readme doesn't do?


Honest response:

Wonderful documentation is hard to beat from my learning perspective, but I find that level of quality is more rare.

Therefore, I learn better by watching something materialize on video at ~3x speed and often without any speaking.

I think it simply boils down to my level of trust that this person didn’t accidentally omit anything from their article or blog post or whatever and what I see on the screen is what I get. Now, that doesn’t fix when tools change etc, but videos instill a higher level of trust that, if I follow these steps, I will produce this output.


Segues to sponsors and screamed content as attempts to keep your attention and to prevent you from falling asleep.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: