После запроса к знающим людям в google группы по ROR выкристализовались три метода чтения документации:

1. непосредственнои из браузера по адресу http://api.rubyonrails.org/
2. При помощи rdoc и gem_server (что дает ту же документацию что и api.rubyonrails, только с localhost)
3. При помощи firefox плагина DevBoi http://www.martincohen.info/products/devboi/. (попробую юзать, мне кажется этот метод самым перспективным). Ключает в себя доку по HTML,CSS,Javascript, и, как плагин, можно доставить Rails 1.1.2 доку. 

Слева в окне - элементы, аттрибуты, свойства, объекты. При даблклике открывает в основном окне ссылку на описание элемента на сайте-источнике. Т.е. по HTML открывается w3c, по Rails открывается api.rubyonrails.org

UDAPTED:
А также, процитирую:

Можно еще юзать http://www.gotapi.com/
Там быстрая навигация по всем нужным докам (Ruby Core, Rails API, HTML,
CSS, JavaScript DOM, Prototype) плюс поиск. Рекоммендую. 

Однако все идет к полноценным двунаправленным клиентским веб-приложениям.

Всем вебдевелоперам, смотреть демку и подбирать под столом упавшую челюсть.
http://minnow.cc.gatech.edu/squeak/uploads/5851/asteroids.htm


А вот и реализация push технологии под Rails
http://juggernaut.rubyforge.org/

Т.е. составить типичные вещи в нем просто, а вот, к примеру, мне нужно сделать отбор по вычисляемому полю, например, цене, которая складывается из цены за юнит умноженной на количество юнитов. Пока ны наю как это сделать.

Вторая неприятность - все передаваемые в запрос значения переменных должны храниться в ЛОКАЛЬНЫХ переменных, а в @переменных это дело работать не будет, а жаль.

А вот и пример моего "дикого запроса".

  def index
      session[:search]=params[:search] if params[:search]      search_params=SearchFilterParams.new(session[:search])
 
    @conditions=Caboose::EZ::Condition.new :lots  do
      region_id==search_params.region_id if search_params.region_id>0
      square<=>(Square.find_by_id(search_params.square.to_s).min_square.to_s .. Square.find_by_id(search_params.square.to_s).max_square.to_s)  if search_params.square>0
      price_per_square<Price.find_by_id(search_params.price_per_square).max_price.to_s if search_params.price_per_square>0
#      full_price<FullPrice.find_by_id(search_params.full_price).max_price.to_s if search_params.full_price>0
      distance_to_city<CityDistance.find_by_id(search_params.distance_to_city).max_distance.to_s if search_params.distance_to_city>0
      placement_id==search_params.placement if search_params.placement>0
   end
## ай-яй-яй, некрасиво  
    @search=search_params
## должен прийти хеш   

## если заданы фильтры   
# order by region_id,square, price_per_square*square, distance
     sort_init 'price_per_square'
     sort_update
    @lot_pages, @lots=paginate(:lots,
      :include=>['region', 'gas','electricity','water', 'lotroad_distance','departure'],
      :order=>sort_clause,
      :conditions=>@conditions.to_sql,
      :per_page=>3
    )
  end class SearchFilterParams
  attr :region_id
  attr :square
  attr :price_per_square
  attr :full_price
  attr :distance_to_city
  attr :placement
  def initialize(lparams={})
    @region_id=lparams[:region_id].to_i
    @square=lparams[:square].to_i
    @price_per_square=lparams[:price_per_square].to_i
    @full_price=lparams[:full_price].to_i
    @distance_to_city=lparams[:distance_to_city].to_i
    @placement=lparams[:placement].to_i
  end
end

Ну как знал что нужно покурить магических манов перед очередным заходом на программинг "под рельсы". Обнаружился замечательный плагин acts_as_dropdown, использование которого вообще тривиально (однако потребовался патч для включения include_blank и include_blank_text. Мы же хотим, что бы пустые значения так же имели возможность быть выбранными, например, комментарии "Выбрать страну", и далее список стран.

Вот здесь подробное описание плагина:
http://delynnberry.com/articles/2006/04/12/acts-as-dropdown-plugin

Внизу в комментах хак для include_blank. 

Суть: включаем в модели таблицы, скажем, Regions
acts_as_dropdown, добавляем параметры по вкусу, :text=>'mytextfieldotherthananme', :include_blank=>true, :include_blank_text=>'выберите вариант'

class Region < ActiveRecord::Base 
acts_as_dropdown :text=>'region', :include_blank=>true,:include_blank_text=>'--не имеет значения--'
end

в view:
<%= select('xxx','yyy',Region.to_dropdown) %>

вот такое плагинистое рельсовое счастье.

Это второй такой плагин сильно облегчающий жизнь, первый обнаруженный мною был file_column для работы с таблицей и записями с изображениями.

Ведь правда, зачастую нет смысла изобретать колесо?  Тем более, что эти колеса еще и неплохо ездят.

http://www.jaikoo.com/articles/2006/02/21/sorting-tables-in-rails-with-associations

Я бы назвал всю направленность IT индустрии и развития в целомемким выражением On demand. У нас буде все on demand, и мы медленно, но уверенно движемся к развитию сервисов в этом направлении.

Будет on demand (по требованию):
* музыка
* фильмы
* изображения
* текст
* приложения
* сервисы

Если посмотреть на современный Интернет, то это и есть предоставление части из этого списка по требованию. Вы читаете новости, слушаете интернет-радио, скачиваете фильмы только ТОГДА, КОГДА этого хочется. А это кардинально отличает принципы работы от работы радио, телевидения, вот причина популярности сети. Вам не нужно просиживать всю ночь у монитора, что бы не пропустить сообщение по icq, или трансляцию матча.

Очень похоже на работу художника:

Подумал-подумал, сделал мазок по холсту, пошел покурить. Покурил, вернулся, прочел немного доки, написал еще одну строчку. Потом день подходит к концу, и ты смотришь на эти две написаные строчки, и понимаешь, что у тебя фактически пол-сайта сделано :)

 И вот этот вот кусок 

    @lot_pages, @lots=paginate(:lots,
      :include=>['region', 'gas','electricity','water', 'lotroad_distance'],
      :per_page     => 10)

В паре с этим:

 <!--пейджер-->
 <table cellpadding="0" cellspacing="3" border="0" align="center">
  <tr>
   <td class="button">
   <%= link_to(image_tag('prev.gif', {:width=>"16",:height=>"16",:border=>"0"}),:page => paginator.current.previous) if paginator.current.previous%>
   </td>         
   <% paginator.each do |page|%>
        <%if page==paginator.current_page then%>
          <td class="pageact"><%= page.number %></a></td>   
        <% else %>
          <td class="page"><%= link_to(page.number,:page=>page)%></td>   
       <% end %>                            
   <% end %>
   <td class="button">
      <%= link_to(image_tag('next.gif', {:width=>"16",:height=>"16",:border=>"0"}),:page => paginator.current.next) if paginator.current.next%>
   </td>
  </tr>
 </table>
 <!--конец:пейджер-->         

Занял бы на php или parser много человеко-часов разработки. Прежде чем писать на Rails нужно брать в руки карандаш, рисовать модель данных до той кондиции, когда у тебя уже не остается сомнений в ее правильности и только после этого можно аккуратно писать первую строку проекта.

Смотрел я на www.korrespondent.net, листал его, читал его. Не покидало меня нездоровое чувство похожести на человека всю жизнь занимающегося рекламой, который стоит перед чьим-то бигбордом высматривая прыщи на лице красотки, что рекламирует очередное средство от перхоти. 

А что же меня смущает? Почему newsru.com, korrespondent.net используют фиксированную ширину верстки? А почему они ориентируются на 800x600? Можно взять за пример очень неплохую резиновую верстку lenta.ru. А если разрешение 1600 на сегодня уже не такая экзотика как раньше, то зачем мне всматриваться в узкую полоску текста посреди браузера.

Воистину век живи - век RTFM. Если вспомнить мою заметку о незаслуженно забытых тегах, то этот найденный тег можно смело помещать в номинацию "самый неожиданный тег года".

Рад представить сообщество рубиистов, рубинистов и рельсистов.

http://community.livejournal.com/ruby_ru/14440.html

Там ссылки на Programming Ruby, 2nd edition и Agile Web Development with Rails.