Learn / Getting Started page about crystal-website HOT 5 CLOSED

I've collected a few ideas for external tutorials, but haven't actually looked at them closely. We should only present ones that have high quality, are up to date and teach a general understanding of Crystal.

• An Introduction to the Crystal Programming Language
• Crystal Programming (video tutorial)
• Crystal Lang Tutorial:Installing Crystal Programming Language (video series)
• A Quick look at Crystal
• Creating a Cryptocurrency in the Crystal Programming Language
• Crystal for Rubyists

from crystal-website.

I would go with

1. Write a better introduction of the book. What information, sections are available, how can be read.
2. Link to that page

Once the book iterate to have a learning flow and not only a language reference this will make more sense. https://forum.crystal-lang.org/t/iterating-the-language-reference-aka-crystal-lang-crystal-book/1080

But I agree that the learn link in the home needs some love.

from crystal-website.

Number 1. is certainly good, but I'm not sure if the book is the perfect place for an in-depth getting starting guide. It would be very difficult to combine a generic language reference with an introduction. Of course, such a guide could be published inside the book, but as an isolated section. I don't think we can adopt the entire book to an incremental learning flow.

IMO the book should be focused on it's main purpose as a language reference. That might include guides but maybe a dedicated platform would be better.

What do you think about the other resources I've mentioned? Should they be referenced somewhere?

from crystal-website.

From the site I would only link official resources for learning + maybe the learning resources forum.

There will always be articles and videos that will be outdated. I prefer the have at least a curated and suggested way to do things in the book. Yet of course not the only one.

The only way to focus on the language itself is to ignore the std-lib. That is more like a spec of the language and I don't think the book will turn into that. There is a balance and mixture of the language, the tools, and the ecosystem. So having guides for different aspects of the development of apps and shards in order to use Crystal as a whole makes sense to me.

from crystal-website.

The main portion of this issue has been sufficiently resolved by the Crystal Book landing page.

I extracted the side issue about collecting learning materials into #287

from crystal-website.