Dotąd uważałem (i nie tylko ja) że dokumentacja do Railsów jest hmmm… nieodpowiednia. Sprawdza się jako referencja, ale już trudno chociażby komuś wysłać link do opisu konkretnej metody (jak w każdej dokumentacji przez RDOC wygenerowanej). Tak wiem, można się dogrzebać do linku, ale zdaje się nie jest to link trwały, bo przy nowej wersji dokumentacji może być do innego wpisu.
Narzekań było sporo, i może teraz będzie trochę lepiej. http://www.noobkit.com/ stara się nieco inaczej przedstawić to samo co jest w RDoc do RoR jak i innych kawałków świata Rubego (włącznie z samym Rubym). Okraszone to wszystko AJAXowym interfejsem, który jednak nie przeszkadza tak bardzo :)
Można też dokumentację komentować, ale wygląda na to, że nie jest to zbyt popularne (ostatni komentarz – 20 dni temu). Jak dla mnie, to jednak możliwość wysłania komuś linku w mailu albo w IM do konkretnego kawałka dokumentacji się przyda.
Popularity: 6% [?]
