art_zh wrote:Абсолютно неубедительная демонстрация на совершенно несущественном примере.
Если это было бы единичным случаем, то да. Но это далеко не единичный случай.
Чтобы далеко не ходить: в svn log sysfuncr.txt есть запись о r1220 от 2009-10-19 (довольно давно, не так ли?), svn diff -c1220 sysfuncr.txt показывает, что добавилось замечание "Предварительно следует инициализировать кучу процесса вызовом подфункции 11" в 68.22. Смотрим в klbr_doc.chm (из 0.7.7.0 или из последней ночной сборки, неважно) и видим там это замечание. Смотрим на
http://wiki.kolibrios.org/wiki/SysFn68/ru и, во-первых, не видим там этого замечания, а во-вторых, видим кучу надругательств над русским языком, таких как пропущенную букву 'н' прямо в заголовке и отсутствие кучи знаков препинания в описании. И ещё уточняю на всякий случай: нет, это всё ещё не единственная ошибка, оставшаяся в описании системных функций с вики.
art_zh wrote:Не вижу противоречия. Обновление идет; третьестепенные темы тоже дождутся своей очереди
Описываю ход дискуссии:
Nasarus: вот моя документация. За основу взят klbr_doc.chm.
art_zh: вики рулит, "там более полная, связная и постоянно обновляемая документация". Вот, например, функции 9 и 62.
diamond: вики - отстой, там куча лажи. Вот, например, функция 18.13. А единственная замеченная ошибка в klbr_doc.chm уже исправлена.
art_zh: ну да, есть лажа, но вики всё равно рулит.
Мне видится противоречие между "таки есть лажа" ("Сразу всего не охватишь") и "таки вики рулит".
art_zh wrote:Очень легко не считать почти сотню статей с десятками перекрестных ссылок, на которые мы втроем ухлопали почти месяц.
Мне жаль, что вы ухлопали целый месяц вашего времени и создали такую лажу притом, что существует нормальная правильная документация по системным функциям. Меня возмущает, что вы рекомендуете эту лажу взамен нормальной доки. Кроме того, мне непонятно, с каких пор и почему качество документации измеряется временем, потраченным на её создание, так что я по-прежнему буду оценивать результат. А он плачевный.
art_zh wrote:Еще легче объявить EmbeddedKOS и PCIDEV (210 и 120 просмотров за 2 месяца) "интересными очень ограниченному контингенту".
Но насчет Kernel/ru - это неуважение к самому себе.
Мне Kernel/ru неинтересна, я и так знаю, что там написано. Прикладникам она тоже неинтересна. А потенциальные ядерщики составляют действительно очень ограниченный контингент. В чём здесь "неуважение к самому себе"?
art_zh wrote:Если корифею влом самому подкорректировать собственные откровения (хотя бы здесь) - пусть не возмущается соавторством чайников.
Это не откровения. А отдельно взятая страница Kernel/ru меня не задевает - я же говорил, что на вики есть и правильная информация тоже.