August Lilleaas wrote:
> Because of the reasons mentioned above. An API is a
reference tool,
> and has a tremendously steep learning curve if you
don't know anything
> about Rails. The API is indeed documentation, but it's
not sufficient
> for a beginner. So, the official documentation is no
good for
> beginners. That's my main concern.
>
> On Dec 14, 2:51 pm, Thijs van der Vossen
<t.vandervos... gmail.com>
August,
I agree that a core doc team is an excellent idea. But it's
also great
that other sites would provide this too. That would mean
that people
could go to whatever site they find more easily(they are
n00b's after
all ;) ) or like better. Plus content could be copied back
and forth if
it was worthwhile and fit both styles. www.rubyonrails/docs
is the
probably the first place people look, and pointing at an API
does look
really bad. Maybe, starting something on that railsbeginner
domain and
hoping to get it moved to rails/docs(/beginner ?) or linked
to from
there would be a good way to get people interested.
Especially as this
has been a fairly well received post. PM once you know what
you are
doing with improving documentation. I'd like to get
involved.
--
Posted via http://www.ruby-forum.com
/.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the
Google Groups "Ruby on Rails: Core" group.
To post to this group, send email to rubyonrails-core googlegroups.com
To unsubscribe from this group, send email to
rubyonrails-core-unsubscribe googlegroups.com
For more options, visit this group at http://groups.google.com/group/rubyonrails-core?hl=en
-~----------~----~----~----~------~----~------~--~---
|