Making Documentation Better

There are lot’s of topics covered here!

I want to chime in in some of the things that are said.

  1. During last week we were actually playing around docusaurus, and at Manas we are really liking it. And it covers most of the points wanted in https://github.com/crystal-lang/crystal-book/issues/261
  2. There are some proposals another structure of the crystal-back here and here. I really think we need to cover first time interactions in a better way. Actually there is PR coming on that direction by @ftarulla.
  3. Although helping Ruby users to feel more comfortable with the language is nice. There is no “migrate from ruby” story. And we should be able to express the value of Crystal without comparing to another language. The fact that we share things with Ruby is because we trust/like those decisions. So I would not make the compatibility with ruby a top story.
4 Likes