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

[metaclass]

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

Comments

[metaclass.livejournal.com]

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

[trueblacker.livejournal.com]

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

[trueblacker.livejournal.com]

впрочем "без документации", конечно, преувеличение. Без "полноценной" документации, имеется ввиду. В соответствии с инженерно-конструторскими традициями.

[nicka-startcev.livejournal.com]

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

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

хотя, тут на днях ставил цивилку5 на винду в виртуалке. Вот там реально нужна нетривиальная интуиция (или навыки пользования Ломазиным) чтоб угадать, чего именно этой программе еще нужно и где это взять.

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

[trueblacker.livejournal.com]

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

[metaclass.livejournal.com]

Кстати, укуренные ошибки выясняются в 5 секунд, просмотром логов винды и, опционально, запуском procmon.

[nicka-startcev.livejournal.com]

при запуске сразу мессаджбокс с некопируемой надписью "приложение не было запущено, поскольку оно некорректно настроено" - это укуреное, или надо в лог лезть? :)

мой гугльфу подсказал мне что надо нет фреймворк ставить. установка нет фреймворков изменила поведение программы. но 666мб памяти этой игрушке мало (падает с другим мутным сообщением), а больше виртуалке давать - получается криво. Итого, забил.

[metaclass.livejournal.com]

Открываешь лог. Там написано "не найдена такая то либа". Все.