Plane

On Tue, 10 Oct 2023, 09:50 İsmail Arılık via ruby-talk, <ruby-talk@ml.ruby-lang.org> wrote:
It is sad that Ruby doesn't have a documentation which is comprehensive like Python's doc. But it is community's responsibility to improve it. It works like that for non-profit projects like Ruby. 

Actually Python's doc is not easy to read. To see a beginner-friendly and also comprehensive doc, see Rust's doc. It is also named "book" and it is for a good reason. 




https://ismailarilik.com

On Mon, Oct 9, 2023, 12:36 Mark Zhang via ruby-talk <ruby-talk@ml.ruby-lang.org> wrote:
Thanks!

I found it   `https://docs.ruby-lang.org/en/3.2/syntax_rdoc.html `. Syntax reference actually did existed.



Антон Щанкин via ruby-talk <ruby-talk@ml.ruby-lang.org> 于2023年10月9日周一 17:16写道:
Hello! Look at https://docs.ruby-lang.org/en/3.2/

09.10.2023 11:55, Mark Zhang via ruby-talk пишет:
> For example:
>
>    Python: https://docs.python.org/3/reference/index.html
>
>  I can read about Python’s syntax and “core semantics” in the document.
>
> But Where is Ruby Official Language Reference/Manual?
>
> ------
> 1) https://ruby-doc.org/
>
> When I try to go to: https://ruby-doc.org/
>
> I found: https://ruby-doc.org/3.2.2
>
> This just explains the Class & API and the SEARCH function is hard to use.
> e.g It cannot search __FILE__ thought it on "Keywords" chapter.
>
> 2) https://rubyreferences.github.io/rubyref/
>
> I can read some "syntax" on this document. But it is not Ruby Official
> Books and it is not up to date.
>
> 3)https://ruby-doc.org/docs/ruby-doc-bundle/Manual/man-1.4/
> I found it with the help of Google.
> I cannot find this document link on https://ruby-doc.org/
> This document is great and written by the author of Ruby.
> It looks like the Ruby Official Manual. But it looks too old which was
> last modified in 1998.
>
>
> -----
>
> So, Where is Ruby's Official Language Reference/Manual?  😂
>
>   ______________________________________________
>   ruby-talk mailing list -- ruby-talk@ml.ruby-lang.org
>   To unsubscribe send an email to ruby-talk-leave@ml.ruby-lang.org
>   ruby-talk info -- https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.org/
 ______________________________________________
 ruby-talk mailing list -- ruby-talk@ml.ruby-lang.org
 To unsubscribe send an email to ruby-talk-leave@ml.ruby-lang.org
 ruby-talk info -- https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.org/
 ______________________________________________
 ruby-talk mailing list -- ruby-talk@ml.ruby-lang.org
 To unsubscribe send an email to ruby-talk-leave@ml.ruby-lang.org
 ruby-talk info -- https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.org/
 ______________________________________________
 ruby-talk mailing list -- ruby-talk@ml.ruby-lang.org
 To unsubscribe send an email to ruby-talk-leave@ml.ruby-lang.org
 ruby-talk info -- https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.org/