Hacker News new | ask | show | jobs
by kup0 1459 days ago
Yes! I think two things with code examples have a significant impact, at least for me personally- 1) the examples are complete and work and 2) line-by-line explanation.

A lot of resources show a snippet of code, followed by an impenetrable paragraph that tries to explain multiple concepts from the snippet all at once. Maybe that works for others, but for me it makes it impossible to parse and overwhelms me, so nothing sticks.

1 comments

This 100%, i often find alot of blogs and documentation really difficult to follow because they just show a snippet and no where in the doc does it cover the prerequisites to get to that point.

I get you don't want to clutter the point, but start with a link to working code or an article that explains the basics.

I would be happy if more articles/docs explained how this code is being called.