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

[metaclass]

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

Comments

[trueblacker.livejournal.com]

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

Имхо, это уже вопрос об искусстве технического писательтсва вообще, а не о линукс-документации в частности.