Why are the ruby docs for a lot of versions incomplete?

ruby-talk
1

Here's an example:

Queue, 2.4.1 : http://ruby-doc.org/core-2.4.1/Queue.html

Queue, 2.2.0 : http://ruby-doc.org/core-2.2.0/Queue.html

The former only lists a brief description and example usage, while the
latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I
should be using?

Regards,
Paul

2

Docs are not the strongest point of Ruby.

···

On Fri, 15 Sep 2017 at 15:51, Paul Kuruvilla <rohitpaulk@gmail.com> wrote:

Here's an example:

Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)

Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)

The former only lists a brief description and example usage, while the
latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I
should be using?

Regards,
Paul

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

--
Sent from Gmail Mobile

3

I wish Ruby also has Python like documentation. :slight_smile:

Thanks,
~A

···

On Sep 15, 2017, at 7:28 PM, Xavier Noria <fxn@hashref.com> wrote:

Docs are not the strongest point of Ruby.

On Fri, 15 Sep 2017 at 15:51, Paul Kuruvilla <rohitpaulk@gmail.com> wrote:
Here's an example:

Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)

Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)

The former only lists a brief description and example usage, while the latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I should be using?

Regards,
Paul

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;
--
Sent from Gmail Mobile

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

.

4

Yeah, not the greatest. Maybe open is or PR to improve?

···

On Fri, Sep 15, 2017 at 6:58 AM Xavier Noria <fxn@hashref.com> wrote:

Docs are not the strongest point of Ruby.

On Fri, 15 Sep 2017 at 15:51, Paul Kuruvilla <rohitpaulk@gmail.com> wrote:

Here's an example:

Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)

Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)

The former only lists a brief description and example usage, while the
latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I
should be using?

Regards,
Paul

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

--
Sent from Gmail Mobile

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

5

Perhaps: Class: Thread::Queue (Ruby 2.4.1)

Queue was reimplemented as Thread::Queue in newer versions,
so I guess the documentation was moved (I don't agree with
the naming change, though).

···

Paul Kuruvilla <rohitpaulk@gmail.com> wrote:

Here's an example:

Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)

Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)

The former only lists a brief description and example usage, while the
latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I
should be using?

6

unsubscribe

···

On Thu, Sep 28, 2017 at 3:40 PM, Ryan Buckley <duhryguy@gmail.com> wrote:

Yeah, not the greatest. Maybe open is or PR to improve?

On Fri, Sep 15, 2017 at 6:58 AM Xavier Noria <fxn@hashref.com> wrote:

Docs are not the strongest point of Ruby.

On Fri, 15 Sep 2017 at 15:51, Paul Kuruvilla <rohitpaulk@gmail.com> >> wrote:

Here's an example:

Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)

Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)

The former only lists a brief description and example usage, while the
latter has documentation for all class + instance methods.

Am I looking at the wrong docs? Is there another documentation site I
should be using?

Regards,
Paul

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=
>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

--
Sent from Gmail Mobile

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

7

You can join http://documenting-ruby.org/ project, for example. Not sure if it’s still active, but I’ve heard about it on the last Ruby conf in Moscow

···

--

On Thursday, Sep 28, 2017 at 10:40 PM, Ryan Buckley <duhryguy@gmail.com (mailto:duhryguy@gmail.com)> wrote:
Yeah, not the greatest. Maybe open is or PR to improve?
On Fri, Sep 15, 2017 at 6:58 AM Xavier Noria <fxn@hashref.com (mailto:fxn@hashref.com)> wrote:
> Docs are not the strongest point of Ruby.
>
>
> On Fri, 15 Sep 2017 at 15:51, Paul Kuruvilla <rohitpaulk@gmail.com (mailto:rohitpaulk@gmail.com)> wrote:
> > Here's an example:
> >
> > Queue, 2.4.1 : Class: Queue (Ruby 2.4.1)
> >
> > Queue, 2.2.0 : Class: Queue (Ruby 2.2.0)
> >
> > The former only lists a brief description and example usage, while the latter has documentation for all class + instance methods.
> >
> > Am I looking at the wrong docs? Is there another documentation site I should be using?
> >
> > Regards,
> > Paul
> >
> > Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
> > <http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;
> --
> Sent from Gmail Mobile
> Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
> <http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;