News for hackers. Stuff that matters.
Re:Some Assembly Required: An approachable introduction to a... by jessicard on Tuesday June 28, 2022 @01:49PM (#31910767)
Ahhhh thank you for mentioning this! This was _really_ important to us, because it was hard for us to find real code examples that worked, and when we did, they were hard to parse.

It's also why we put it in GitHub, so it could live alongside the code examples :)

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.