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

[metaclass]

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

Comments

[swizard.livejournal.com]

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

Не надо вести никакую документацию, это провал. Язык должен быть самодокументируемым, рантайм должен иметь мощный RTTI, и среда должна быть глубоко интегрирована с рантаймом и иметь развитые возможности по навигации по коду.

Имея CL + slime я уже забыл, когда я зачем-либо лез в гугл для поиска информации по языку или библиотеке. Всегда к услугам describe, slime-inspect, slime-apropos, slime-apropos-package и навигация по slime-edit-definition. И, что самое ценное здесь, всё всегда де-факто актуально :)

Подозреваю, что для Closure всё это добро доступно. Надо просто освоить slime :)

[metaclass.livejournal.com]

Доступно, через swank

[theiced.livejournal.com]

ребе уже поставил емакс, всё в процессе.

[avnik.livejournal.com]

Вы таки ввели уважаемого ребе в круг Holy Emacs Church?

[theiced.livejournal.com]

пока свидетелем :]

[avnik.livejournal.com]

Вот у меня хорошо в емаксе пишутся тексты на натуральный языках, а всякий код почему-то в vi

[mend0za.livejournal.com]

"Свидетели Емакса" и "Адвентисты летающей антилопы седьмого дня".