Ответ на вопрос "почему": потому что я не документатор ;) Ответ на вопрос "что делать": хорошо бы составить желательный план документации (и занести на wiki в раздел TODO)- я бы тогда мог заполнить бы этот план реальным содержимым
25.03.08, Grigory Batalov<[EMAIL PROTECTED]> написал(а): > On Fri, 21 Mar 2008 18:32:35 +0300, Stanislav Ievlev wrote: > > > ТЗ вырастет из TODO ;) > > В TODO написано, что это "Планы по развитию alterator": > http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/todo > Планы по развитию - это не техническое задание. > > http://freesource.info/wiki/AltLinux/Sisyphus/Alterator > > Документация по альтератору ужасающая. Несмотря на обилие примеров и цитат > кода на scheme, она не даёт ответ на вопрос: "Зачем всё это нужно?" > > Сейчас этой документацией может воспользоваться только Владислав Завьялов, > т.к. он участвует в развитии платформы. А что делать писателям модулей? > Как получить представление о платформе, не влезая в дебри scheme? > > Почему все разделы вывалены на одну страницу? Откуда мне знать, что > нужно зайти в четвёртый (!) блок ссылок с названием FBI? > > Почему в документации нет ни одной картинки? (Скриншоты "hello, world" > не в счёт, но даже они убогие.) > > > > > > Не пора ли нам замахнуться на планирование разработки нашего > альтератора? > > > > > > Так и ТЗ давно пора написать, но некому. > > > -- > Grigory Batalov, > ALT Linux Team > > _______________________________________________ > > devel-conf mailing list > [email protected] > https://lists.altlinux.org/mailman/listinfo/devel-conf _______________________________________________ devel-conf mailing list [email protected] https://lists.altlinux.org/mailman/listinfo/devel-conf
