News for hackers. Stuff that matters.
Re:Ask HN: Do you find developer screencasts useful? by dirkstoop on Saturday December 05, 2009 @11:45AM (#978224)
Jacob Kaplan-Moss recently wrote a series of really good articles about writing good documentation, I highly recommend reading them if you're about to embark on making technical docs:

http://jacobian.org/writing/great-documentation/

He subdivides documentation as a whole into more or less the following three sections:

- Tutorials

- Topical Guides

- Reference

Screencasts can work for Tutorials, and they can be used for marketing purposes, in which they're closer to topical guides but probably won't provide as much depth as a textual guide could.

Imho. a screencast can be great as a marketing tool, but not so much as a learning tool.

Re:Ask HN: Do you find developer screencasts useful? by chasingsparks on Saturday December 05, 2009 @11:54AM (#978238)
Jacob's docs were fantastic. I read them after they were posted on HN a few weeks back.

The marketing aspect is pretty important. I was considering following his (my friend's) advice for that reason. Every week or so there seems to be a "Watch me build a blog in 5 minutes" screencast. I don't really think they are tutorials; they are closer to movie trailers.

Re:Ask HN: Do you find developer screencasts useful? by dirkstoop on Saturday December 05, 2009 @12:05PM (#978246)
I agree, I remember seeing some old RoR screencasts a couple years back, thinking: That editor is awesome. That's what made buy a copy of TextMate. (I still haven't ever used RoR tho)