Document your code just by hitting “record”

Re:Document your code just by hitting “record” by hodgesrm on Tuesday November 03, 2020 @09:24PM (#24986097)

+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.

[ Parent | on HN ]

Re:Document your code just by hitting “record” by tomatohs on Wednesday November 04, 2020 @12:41AM (#24986630)

Why not both?

[ Parent | on HN ]

Re:Document your code just by hitting “record” by eru on Wednesday November 04, 2020 @06:04AM (#24988005)

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

[ Parent | on HN ]

Re:Document your code just by hitting “record” by technoplato on Wednesday November 04, 2020 @06:46AM (#24988188)

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.

[ Parent | on HN ]

Re:Document your code just by hitting “record” by jraph on Wednesday November 04, 2020 @06:39AM (#24988161)

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

[ Parent | on HN ]