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

[metaclass]

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

Comments

[guamoka.livejournal.com]

ИМХО, лишний раз подтверждает, что наличие такого количества недокументированного программного кода- это код ради кода. Он делает "всё то же самое, но с сиреневым оттенком". Соответственно, и документация- лишнее. Потому что авторы сами нихрена не знают, что же они пытаются сделать. И уж тем более у них нет слов, чтобы объяснить это:-) Известная проблема с кодерами. Чем "продуктивнее" кодер, тем сложнее у него с речевым аппаратом и изложением мыслей словами.
Кстати, вот еще одна распространённая мантра насчет "самодокументированного" кода. Это бляц пиздец несусветный, мем, вброшенный в мозги программистишкам, привыкшим делать "вещь в себе". Таким образом, полагается, что а) задачу можно решить одним единственным способом, поэтому код однозначно отражает постановку задачи (с хера ли?) б) исходный код- это не реализация решения- инструкция компилятору-машине, а вся проектировочно-дизайнерско-планировачная шняга в одном флаконе, необходимая для решения какой-то реальной задачи:-)

[tonsky.livejournal.com]

Боюсь, что авторы Кложи (о которой речь в посте) слишком хорошо понимают, зачем они что делают и какие задачи решают. Вот, к примеру: http://tonsky.livejournal.com/243192.html. Это вполне конкретные, серьезные и нерешенные проблемы, и они действительно ими успешно решаются. Рич Хики вообще один из умнейших программистов сейчас. Не работает ваше гадание на кофейной гуще.

[guamoka.livejournal.com]

Да. Есть еще худший вариант- это когда даже не понимаешь, чего не понимаешь;-) Тогда, да, и кофейная гуща не помошник.

[theiced.livejournal.com]

вы в очредной раз показали себя тупым гандоном. поздравляю.

[guamoka.livejournal.com]

Вы жалкий.