I’m an experienced programmer interested in exploring Crystal for some personal projects.
I’m working my way through the Crystal Language Reference as well as trying to understand a variety of code snippets I’ve found online (.e.g https://github.com/askn/crystal-by-example).
I find myself frustrated by the lack of documentation and explanation of basic syntax and idioms in the language reference. A few examples of this:
No where in the language reference does it explicitly say “<<” is the append operator for arrays. This page (https://crystal-lang.org/reference/syntax_and_semantics/literals/array.html) gives an example of this, but if you don’t already know the operator a search on “append” in the manual search box doesn’t help. Similarly, there is no example for such basic operations as getting the length of an array (must resort to Google to find examples)
There is inadequate explanation of the iterator syntax in the reference; to grok the iterator syntax I found I had to resort to reading a Ruby tutorial.
Short of learning Ruby, and then coming back to Crystal, is there some other tutorial or reference resource that I should be reading?