Marnen Laibow-Koser wrote:
...
>
>> (From Ken:)
>> I find the Rails documentation frustrating because so much is left out.
>
> Left out? What do you mean? Do you have a concrete example?
>
>> Then I spend hours testing, digging and reading. Maybe I am just
>> thick-headed.
Yes. Take form_tag. Even on RailsBrain. Go to the top of the page.
It doesn't tell you What and Why. What, exactly, is a form_tag?
I gather it is some sort of a shorthand. Why? If the regular form usage
is too long then why not just get rid of it? Besides, what, exactly, is
a "tag?" A helper? An abbreviation? If we need "helpers", maybe, the
superclass is somewhat antiquated? Hmmm?
What about this? text_field_tag(name, value = nil, options = {})
Creates a standard text field; use these text fields to input smaller
chunks of text like a username or a search query.
Ok. How much smaller? Only 4 letters? 20 letters? And why isn't the
text_field adequate for this? Or why is it too cumbersome?
You see? Not very much detail. Of course, if you're experienced at all
this stuff then it all makes sense. On the other hand, how do you get
experienced with this stuff? I just start doing some coding and fiddle
with it until it makes sense or it drives me crazy. Either way it eats
up a LOT of time.
The documentation could be light-years better. IMFO. ('F' for FERVENT.)
HTH,
Ken
--
Posted via http://www.ruby-forum.com/.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Ruby
on Rails: Talk" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/rubyonrails-talk?hl=en
-~----------~----~----~----~------~----~------~--~---
