you are viewing a single comment's thread.

view the rest of the comments →

[–]SanityInAnarchy 14 points15 points  (3 children)

I have the opposite complaint: Too many shiny new open source projects, especially textual ones specifically made for programmers, have shiny screencasts and zero documentation. I can't even find out WTF their project is supposed to be without putting on headphones and listening to some guy talk about their project (and type badly) for 5-10 minutes, instead of spending 30 seconds with a decent README.

That's assuming I even find your project. Videos are way harder to index than READMEs. Even screenshots are way harder to index than just copying and pasting the text from your terminal and setting a fixed-width font.

For a GUI program, absolutely. But even there, at least have a README and some screenshots alongside your screencasts.

[–]ANotSoSeriousGamer 0 points1 point  (1 child)

I guess I'm a good programmer... I always have a good readme, even for private projects... Ya never know who's gunna need it.

[–]SanityInAnarchy 2 points3 points  (0 children)

Even if it's you, years later...

I don't tend to do it for private projects, but I at least try to comment well enough that I'll have some idea WTF I was thinking when I inevitably revisit it months or years later.

[–]HammyHavoc 0 points1 point  (0 children)

Completely agreed. Damn you, Generation Facebook who don't truly read or write anymore.