Ask HN: Best practices for dev-focused How to guides/tutorials?

Y	Hacker News new \| ask \| show \| jobs

1 points by aeromusek 3447 days ago

What is the best technical tutorial you’ve seen, and why did you love it?

Screenshots and code snippets of course, but what about animated GIFs? Succinct numbered steps, or descriptive paragraphs? Are well-edited videos better than text?

Background: I’m writing a few basic tutorials on implementing popular mobile app features. I know what I like in a guide, but…confirmation bias is a thing.

1 comments

onion2k 3447 days ago

Specific version numbers of everything used and a very clear date the article was written. A message to deprecate it when it's out of date too. This is especially important if the article targets an alpha (eg an API may change and the article becomes redundant).

link