Мозаичная документация

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

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

Собственно говоря, эти фреймворки и внутри так же оформлены, loose coupling и модульная архитектура, так сказать. Практически ни один проект не является self-contained и пригодным для изучения с нуля - желательно знать заранее основы того, что пытаешся прочесть в документации.

Попытка осилить Ruby on Rails поимела неожиданный побочный эффект

Читаю:
http://wiki.eclipse.org/Jetty/Starting
http://maven.apache.org/guides/getting-started/index.html
Жабья инфраструктура больше не вызывает отторжения в мозгу, после хаскелей, рубей, рельсов и прочего. Ребе theiced будет фшоке.

Разница с предыдущими попытками осилить: прочитал Эккеля "Философию жабы", использовал/модифицировал несколько полезных жабьих приложений (консольных, без инфраструктуры) и наконец-то понял зачем нужен maven, после того как как следует попользовался аналогичным ему хаскелевым cabal).