Re:Some Assembly Required: An approachable introduction to a...
by kup0 on Tuesday June 28, 2022 @03:31PM
(#31911991)
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.
Re:Some Assembly Required: An approachable introduction to a...
by NationOfJoe on Tuesday June 28, 2022 @07:56PM
(#31914675)
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.
It's also why we put it in GitHub, so it could live alongside the code examples :)