I'm new to both ruby and rails, coming from lots of experience with other 
languages and frameworks, and I'm struck by how poor the rails source code 
documentation is. For example, I'm looking 
at 
activerecord-3.2.13/lib/active_record/connection_adapters/abstract/quoting.rb, 
which contains

>
>       # Quotes the column value to help prevent
>       # {SQL injection 
> attacks}[http://en.wikipedia.org/wiki/SQL_injection].
>       def quote(value, column = nil)


I understand that it's debatable whether or not an end-user should directly 
use this, but my googling finds that many end users do in fact use it ...

How should I go about finding the answer to questions like "What is the 
'column' argument? When might I want to use it?". I.e., I hoped the 
comments near the method definition would help ... is there a Ruby Way to 
answer these kinds of questions?

Assuming my complaint about the lack of documentation is legitimate, what's 
being done to correct it? How can I help?

-- 
You received this message because you are subscribed to the Google Groups "Ruby 
on Rails: Talk" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/rubyonrails-talk/19e7e1a0-0715-45e1-a9bc-539e971cec2f%40googlegroups.com?hl=en-US.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to