О документации

[metaclass]

Опен-сорсным проектам нужно на пару лет прекращать доработки кода за исключением security и поддержки текущего состояния смежных проектов, и занятся документацией.
А особенно - зачисткой гугла от 100500 копий сообщений в списках рассылки, дубликатов wiki и тому подобного, по устаревшим версиям библиотек.
Потому что сейчас любой вопрос гуглу возвращает информацию начиная от 2004 года(а то иногда и раньше), которая устарела как неизвестно что.
А когда язык развивается быстрее, чем гугл успевает индексировать - то разобраться, скажем, что clojure.contrib уже не модно использовать, практически нереально.

Comments

[http://users.livejournal.com/zubr_/]

У Гугля неприлично долгая память, так что не вариант.

Ну и оффтоп. Лично у меня с документацией самая главная проблема в моменте, когда её уже пора писать.
Обычно кажется "вот чуть-чуть допилю до релизной версии, и оформлю доку". И приложение в состоянии вечного release candidate с отставшей на две-три версии документацией (if any)