[ruby-talk:444343] Where is Ruby Official Language Reference/Manual ?

For example:

   Python: The Python Language Reference — Python 3.12.0 documentation

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: RDoc Documentation

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) Introduction - Ruby Reference

I can read some "syntax" on this document. But it is not Ruby Official
Books and it is not up to date.

3)Ruby Language Reference Manual
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? :joy:

Hello! Look at Documentation for Ruby 3.2

09.10.2023 11:55, Mark Zhang via ruby-talk пишет:

···

For example:

Python: The Python Language Reference — Python 3.12.0 documentation

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: RDoc Documentation

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) Introduction - Ruby Reference

I can read some "syntax" on this document. But it is not Ruby Official Books and it is not up to date.

3)Ruby Language Reference Manual
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? :joy:

  ______________________________________________
  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 -- Info | ruby-talk@ml.ruby-lang.org - 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 -- Info | ruby-talk@ml.ruby-lang.org - ml.ruby-lang.org

Quoting Антон Щанкин via ruby-talk (ruby-talk@ml.ruby-lang.org):

Hello! Look at Documentation for Ruby 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

···

Subject: [ruby-talk:444344] Re: Where is Ruby Official Language Reference/Manual ?
  Date: Mon 09 Oct 23 12:16:12PM +0300

--
  * 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)
______________________________________________
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 -- Info | ruby-talk@ml.ruby-lang.org - ml.ruby-lang.org

Thanks!

I found it `syntax - Documentation for Ruby 3.2 `. Syntax
reference actually did existed.

Антон Щанкин via ruby-talk <ruby-talk@ml.ruby-lang.org> 于2023年10月9日周一
17:16写道:

···

Hello! Look at Documentation for Ruby 3.2

09.10.2023 11:55, Mark Zhang via ruby-talk пишет:
> For example:
>
> Python: The Python Language Reference — Python 3.12.0 documentation
>
> 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: RDoc Documentation
>
> 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) Introduction - Ruby Reference
>
> I can read some "syntax" on this document. But it is not Ruby Official
> Books and it is not up to date.
>
> 3)Ruby Language Reference Manual
> 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? :joy:
>
> ______________________________________________
> 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - 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.

···

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

Thanks!

I found it `syntax - Documentation for Ruby 3.2 `.
Syntax reference actually did existed.

Антон Щанкин via ruby-talk <ruby-talk@ml.ruby-lang.org> 于2023年10月9日周一
17:16写道:

Hello! Look at Documentation for Ruby 3.2

09.10.2023 11:55, Mark Zhang via ruby-talk пишет:
> For example:
>
> Python: The Python Language Reference — Python 3.12.0 documentation
>
> 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: RDoc Documentation
>
> 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) Introduction - Ruby Reference
>
> I can read some "syntax" on this document. But it is not Ruby Official
> Books and it is not up to date.
>
> 3)Ruby Language Reference Manual
> 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? :joy:
>
> ______________________________________________
> 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - 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.

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 `syntax - Documentation for Ruby 3.2 `.
Syntax reference actually did existed.

Антон Щанкин via ruby-talk <ruby-talk@ml.ruby-lang.org> 于2023年10月9日周一
17:16写道:

Hello! Look at Documentation for Ruby 3.2

09.10.2023 11:55, Mark Zhang via ruby-talk пишет:
> For example:
>
> Python: The Python Language Reference — Python 3.12.0 documentation
>
> 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: RDoc Documentation
>
> 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) Introduction - Ruby Reference
>
> I can read some "syntax" on this document. But it is not Ruby Official
> Books and it is not up to date.
>
> 3)Ruby Language Reference Manual
> 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? :joy:
>
> ______________________________________________
> 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - 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 --
Info | ruby-talk@ml.ruby-lang.org - ml.ruby-lang.org