From: Josh Cheek <josh.cheek@...>
Date: 2012-04-23T22:07:31+09:00
Subject: Re: To developers of Ruby: Feeble documentation - weakness of Ruby and the Ruby on Rails (2nd editio

--0016e6dd98d100e1f004be585260
Content-Type: text/plain; charset=ISO-8859-1

On Mon, Apr 23, 2012 at 5:11 AM, Brian Candler <lists@ruby-forum.com> wrote:

> I think you are a bit confused.
>
> Ruby is a programming language. Rails is a web framework (which just
> happens to be written in Ruby). They are two completely separate things.
> Complaining about them both together is like complaining about Sendmail
> and C together (just because Sendmail happens to be written in C)
>
> If you have suggestions for Rails, please send them to a Rails forum or
> mailing list.
>
> As for documentation: there is very good commercial documentation
> available for both Ruby and Rails - for a few dollars you can get very
> good PDFs. If you don't want to pay this, then the first edition of the
> Pickaxe book is still available online for free and remains a good
> starting point: http://www.ruby-doc.org/docs/ProgrammingRuby/
>
> I agree with you that the bundled documentation for the ruby language
> itself is poor, but I don't think that complaining about it will help.
> If you'd like to contribute, I'm sure your efforts would be gratefully
> accepted.
>
> --
> Posted via http://www.ruby-forum.com/.
>
>
Hmm, don't have the email you're responding to in my inbox -.^

Anyway, I think the OP is wrong, Rails has really great docs:

http://guides.rubyonrails.org/
http://api.rubyonrails.org/

--0016e6dd98d100e1f004be585260
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Mon, Apr 23, 2012 at 5:11 AM, Brian Candler <span dir=3D"ltr">&lt;<a hre=
f=3D"mailto:lists@ruby-forum.com">lists@ruby-forum.com</a>&gt;</span> wrote=
:<br><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" style=3D"=
margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I think you are a bit confused.<br>
<br>
Ruby is a programming language. Rails is a web framework (which just<br>
happens to be written in Ruby). They are two completely separate things.<br=
>
Complaining about them both together is like complaining about Sendmail<br>
and C together (just because Sendmail happens to be written in C)<br>
<br>
If you have suggestions for Rails, please send them to a Rails forum or<br>
mailing list.<br>
<br>
As for documentation: there is very good commercial documentation<br>
available for both Ruby and Rails - for a few dollars you can get very<br>
good PDFs. If you don&#39;t want to pay this, then the first edition of the=
<br>
Pickaxe book is still available online for free and remains a good<br>
starting point: <a href=3D"http://www.ruby-doc.org/docs/ProgrammingRuby/" t=
arget=3D"_blank">http://www.ruby-doc.org/docs/ProgrammingRuby/</a><br>
<br>
I agree with you that the bundled documentation for the ruby language<br>
itself is poor, but I don&#39;t think that complaining about it will help.<=
br>
If you&#39;d like to contribute, I&#39;m sure your efforts would be gratefu=
lly<br>
accepted.<br>
<span class=3D"HOEnZb"><font color=3D"#888888"><br>
--<br>
Posted via <a href=3D"http://www.ruby-forum.com/" target=3D"_blank">http://=
www.ruby-forum.com/</a>.<br>
<br>
</font></span></blockquote></div><br><div>Hmm, don&#39;t have the email you=
&#39;re responding to in my inbox -.^</div><div><br></div><div>Anyway, I th=
ink the OP is wrong, Rails has really great docs:</div><div><br></div>
<div><a href=3D"http://guides.rubyonrails.org/">http://guides.rubyonrails.o=
rg/</a></div><div><a href=3D"http://api.rubyonrails.org/">http://api.rubyon=
rails.org/</a></div>

--0016e6dd98d100e1f004be585260--