![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png){kind=small}
О документации
Опен-сорсным проектам нужно на пару лет прекращать доработки кода за исключением security и поддержки текущего состояния смежных проектов, и занятся документацией.
А особенно - зачисткой гугла от 100500 копий сообщений в списках рассылки, дубликатов wiki и тому подобного, по устаревшим версиям библиотек.
Потому что сейчас любой вопрос гуглу возвращает информацию начиная от 2004 года(а то иногда и раньше), которая устарела как неизвестно что.
А когда язык развивается быстрее, чем гугл успевает индексировать - то разобраться, скажем, что clojure.contrib уже не модно использовать, практически нереально.
А особенно - зачисткой гугла от 100500 копий сообщений в списках рассылки, дубликатов wiki и тому подобного, по устаревшим версиям библиотек.
Потому что сейчас любой вопрос гуглу возвращает информацию начиная от 2004 года(а то иногда и раньше), которая устарела как неизвестно что.
А когда язык развивается быстрее, чем гугл успевает индексировать - то разобраться, скажем, что clojure.contrib уже не модно использовать, практически нереально.
no subject
Не надо вести никакую документацию, это провал. Язык должен быть самодокументируемым, рантайм должен иметь мощный RTTI, и среда должна быть глубоко интегрирована с рантаймом и иметь развитые возможности по навигации по коду.
Имея CL + slime я уже забыл, когда я зачем-либо лез в гугл для поиска информации по языку или библиотеке. Всегда к услугам describe, slime-inspect, slime-apropos, slime-apropos-package и навигация по slime-edit-definition. И, что самое ценное здесь, всё всегда де-факто актуально :)
Подозреваю, что для Closure всё это добро доступно. Надо просто освоить slime :)
no subject
no subject
no subject
no subject
no subject
no subject