website icon indicating copy to clipboard operation
website copied to clipboard

Need "Tips" guide to ease the plight of the new user

Open BrucePerens opened this issue 4 years ago • 2 comments

Upon returning to this platform after a time, I hit all of the problems I hit the first time. These should be in a "Tips" guide.

What "needs" does to the underlying code.

How to write type-specific code, specifically the need for the value which is classified using is_a? to be in a local variable. Yes, this is really a crystal-language issue, but every user will hit it.

How to debug various macro expansions, which seem to obscure which statement the user wrote that is the cause of the error, and instead present lots of macro cybercrud that the user didn't write. Specifically, the macro expansions regarding * Declaring models. * Migrations.

BrucePerens avatar May 13 '20 22:05 BrucePerens

Welcome back! Glad to see you around. You're right in that coming in as a newcomer there's just a ton of things that you have to wade through. Do you think a whole guide would be needed, or would maybe a "beginner's tutorial" blog post be more helpful? I'm trying to think of how this could be best structured since there's just so much, and I'm not sure what the line is between "we've shown enough, now go and learn!" vs stuff we can show to help the 90% case of newcomers to both crystal and lucky 🤔

In any case, having something has definitely been on our radar for a bit now.

jwoertink avatar May 13 '20 22:05 jwoertink

It needs to be where people would read it. Thus, I would suggest a guide. Blog posts are too hard to find, especially as they age.

BrucePerens avatar May 13 '20 22:05 BrucePerens