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

[metaclass]

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

Comments

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

Поисковик проиндексировал.
Как заставить "забыть" проиндексированное? При условии, что оно продолжает храниться в виде "версии" и по-прежнему доступно?

[metaclass.livejournal.com]

Грохнуть старые ресурсы, написать на них и гугл сам про них забудет со временем

[nicka-startcev.livejournal.com]

если бардак нельзя прекратить, то его можно/нужно возглавить.
если на сайте первоавтора проекта есть все нужные ссылки (сырцы, доки, вики, форумы, хауту, примеры), то большинство "пользователей" будет пользоваться ими и тусоваться там, а не на левых форумах.

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

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

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