= Сообщение: 330 из 2393 ================================= RU.FIDONET.DIGEST = От : Vladimir Fyodorov 2:50/15 17 Sep 15 20:02:04 Кому : All 17 Sep 15 20:02:04 Тема : R50.SYSOP, RU.HUSKY: О документации к пакету HUSKY FGHI : area://RU.FIDONET.DIGEST?msgid=2:50/15+55faf211 = Кодировка сообщения определена как: CP866 ================================== ==============================================================================
> Михаил Дукельский обратился с просьбой о помощи в составлении полной > документации на пакет HUSKY. Неужели то, о чём так долго говорили > большев^W^W Олег Певзнер в R50.SYSOP, свершится?
============================================================================= * Area : R50.SYSOP * From : Oleg Pevzner, 2:464/5555 (11 Сентября 2015 22:16) * To : Max Vasilyev * Subj : ююки ============================================================================= MV> Базовая логика, т.е. порядок следования друг за другом частей конфига MV> (сначала пути, потом роботы, потом эхи и как оно все описывается MV> понимается по примеру из документации husky-all-1.9-docs-20150909.zip MV> вот тут: \huskybse\config\config
Согласен. Hо... ты понимаешь разницу между настройкой всего по принципу "Ура, у меня заработало!" и уверенными и предсказуемыми действиями аналогичного характера? Меня не устраивает именно то, что, работая с фастэхой, я совершенно точно знаю, что я получу в итоге, а вот работая с hpt, превращаюсь в вечного экспериментатора. Возможно, я уже вырос из этого возраста просто, но меня в самом деле этот момент отталкивает.
MV> А дальше изучить \fidoconf\doc\fidoconfig.html MV> Это справочник по токенам конфига. MV> Узнаешь, что вообще можно в husky. Там и логика расписана, если она не MV> видна из названия токена. Задание очередности форвардов подписки, MV> например. После будешь понимать вывод tparser'a и сможешь дописать в MV> конфиг то, что нужно.
Повторюсь, я не говорю, что не могу в принципе настроить husky. Меня не устраивает то, что я не могу ее обозреть целиком, всю! Я постоянно где-то что-то должен искать, собирать, выуживать по мелочам и все такое. Hе устраивает ведь не просто документация, не устраивает сам стиль ее написания. Примеры в ней быть должны обязательно и это прекрасно, что они есть, но сама документация не может и не должна строиться на одних примерах. Прежде всего, должна быть описана логика работы и взаимодействия ключевых процессов. Затем неплохи ссылки на пример конфигурации, которые бы эту логику наглядно иллюстрировали. Здесь же предлагается обратное - сначала ковыряйся в готовых конфигах, на их основе постигай логику. Hикогда таким образом это сделать не получится. В лучшем случае удастся просто повторить или адаптировать чужие конфиги под себя, но ты сам никогда до конца не будешь знать и понимать, как работает программа и чего от нее можно ожидать. Я лишь об этом всячески пишу. =============================================================================
============================================================================= * Area : RU.HUSKY * From : Michael Dukelsky, 2:5020/1042 (17 Сентября 2015 17:43) * Subj : We need your help ============================================================================= Hello All,
The Husky project documentation is far from ideal. Essentially we have only 3 reference manuals on fidoconfig, hpt and htick but there is no user manual, not to mention a tutorial. The reference manuals list all keywords in alphabet order while a user manual should explain how the programs can be used. But even the existing manuals have flaws. It would be wonderful if you could help with improving the documentation.
Here is what has to be done with the existing manuals.
1. There is 'A working sample config' in the fidoconfig manual. It is for husky 1.4 and it is not valid for husky 1.9. So the first and most important task is to replace it with a sample config working in husky 1.9.
2. A fidoconfig structure has to be described in general (in the fidoconfig manual).
3. 'Highly Portable Tosser keywords' and 'HTick (Husky Ticker) keywords' lists in the fidoconfig manual should be updated to the current status.
4. Hpt manual needs 'HPT 1.9 Command Line OPTIONS and SWITCHES' section on the analogy of such a section in the htick manual.
5. Only hpt and htick have manuals. Maybe it is worth to add one more manual where all other utilities that usually accompany hpt and htick are described.
