[ruby-talk:444343] Where is Ruby Official Language Reference/Manual ?
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? 😂
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...
Subject: [ruby-talk:444344] Re: Where is Ruby Official Language Reference/Manual ? Date: Mon 09 Oct 23 12:16:12PM +0300 Quoting Антон Щанкин via ruby-talk (ruby-talk@ml.ruby-lang.org):
Hello! Look at https://docs.ruby-lang.org/en/3.2/
There too, __FILE__ cannot be found by searching. Looks like the search function needs to be made a bit more comprehensive... Mark: to know about __FILE__ hou can refer to the keywords page: https://docs.ruby-lang.org/en/3.2/keywords_rdoc.html Carlo -- * Se la Strada e la sua Virtu' non fossero state messe da parte, * K * Carlo E. Prelz - fluido@fluido.as che bisogno ci sarebbe * di parlare tanto di amore e di rettitudine? (Chuang-Tzu)
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...
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...
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.
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...
participants (5)
-
Carlo E. Prelz -
İsmail Arılık -
Mark Zhang -
Rod Mwende -
Антон Щанкин