Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[RFC] Collection of learning materials for Crystal #287

Open
straight-shoota opened this issue Mar 11, 2022 · 0 comments
Open

[RFC] Collection of learning materials for Crystal #287

straight-shoota opened this issue Mar 11, 2022 · 0 comments

Comments

@straight-shoota
Copy link
Member

straight-shoota commented Mar 11, 2022

In the Crystal Book we have several learning materials: a structured tutorial and guides on specific topics. They are easily accessible from the Book landing page. However, there are also many good 3rd party resources that we're currently not linking anywhere.
It would be useful, especially for newcomers, to have a curated list of learning materials about Crystal.
I had already started collecting some ideas on #98, but this really deserves a separate issue.

As an example, these are some extensive courses on Crystal:

Other materials.

The list can of course also included other kinds of resources, such as "hardware" books etc.

There are many different categories for learning materials, so I think it would make sense to establish some kind of taxonomy. The details are to be determined.
The materials should be curated to ensure a minimum level of quality and relevance. For example, it would be useless for learners if they're presented with 10 different blog posts about how to write Hello World. We ought to pick the best ones (that's subjective, of course, but what can you do...).
Evaluating the quality of non-publicly available resource could be difficult. But I'm sure we can ask providers of such materials for access in return for endorsement.
Accessibility restrictions should be recorded in the list, of course.

An important metric regarding quality is also how up to date a resource is. For example, an introduction to Crystal 1.0 would still probably be mostly accurate for the latest Crystal release (1.4), but readers will miss out on recent additions. For older versions, there will likely be even some incompatibilities. So it might be a good idea to record the Crystal version each resource is targeting (and keep tracking that when it upgrades).

I'm writing this issue on crystal-website, but I'm not decided about the final location. It could be part of this repo, or https://github.com/crystal-lang/crystal-book. Maybe even a stand-alone resource similar to https://github.com/veelenga/awesome-crystal (that could still be integrated into the website, of course).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant