= Сообщение: 715 из 5336 ========================================== RU.HUSKY =
От : Michael Dukelsky 2:5020/1042 01 Nov 14 14:51:58
Кому : Oleg Pevzner 01 Nov 14 14:51:58
Тема : бага нашлась
FGHI : area://RU.HUSKY?msgid=2:5020/1042+5454ce25
На : area://RU.HUSKY?msgid=2:464/5555+54541929
= Кодировка сообщения определена как: CP866 ==================================
Ответ: area://RU.HUSKY?msgid=2:464/5555+5455296d
==============================================================================
Привет, Oleg!
31 Oct 14 23:43, Oleg Pevzner послал(а) письмо к All:
OP> Извиняюсь, если влажу в дискуссию, но... Затронута чрезвычайно
OP> важная и принципиальная тема. Скажем так... Дело не просто в том, что
OP> предлагаемая документация - действительно справочник, ориентироваться
OP> в котором легко лишь тогда, когда хорошо и твердо знаешь, что ищешь. А
OP> если не знаешь? Если хочешь, прежде всего, разобраться в концепции,
OP> понять взаимосвязи между различными опциями, определить возможную
OP> несовместимость между опциями и их значениями и т.п.? Также далеко не
OP> всегда очевидны значения многих параметров по умолчанию. Как по мне,
OP> именно эти вопросы являются наиболее важным и принципиальным в плане
OP> документации, и именно этого в самом деле не хватает. И это - не те
OP> вещи, которые может сделать кто угодно, здесь важна рука
OP> разработчиков.
Здесь есть две проблемы. Первая: разработчиков, которые писали большие куски проекта, здесь не осталось. Вторая: чтобы написать толковую документацию, надо быть не программистом, а техническим писателем. Это совершенно отдельное умение, никак не связанное с умением писать программы. К сожалению, таких людей, насколько я понимаю, тут не было и нет.
OP> Помогать им можно и нужно, но помощь, как мне кажется,
OP> должна правильно распределяться. Скажем, например, перевод
OP> документации на русский язык действительно может сделать любой
OP> заинтересованный человек, владеющий английским. Верстку, подготовку
OP> требуемого формата и т.п. - то есть, техническую работу - аналогично.
OP> Hо принципиальную часть описания все же хотелось бы иметь именно от
OP> разработчиков. Лично мне, например, очень сильно не достает именно
OP> описания логики.
То есть тебе не хватает руководства пользователя. См. выше.
[...skipped...]
OP> Важным (по крайней мере, для меня) оказалось осознание структуры
OP> секций конфигурационного файла, в частности, какие параметры в каких
OP> секциях задаются (и, кстати, почему именно так, а не иначе).
Ну вот, наконец-то первое конкретное замечание. Да, это действительно надо написать. Кто возьмётся?
OP> Разумеется, там много
OP> очевидного, но встречаются и достаточно нетривиальные вещи. Справочник
OP> должен легко читаться, также должен быть организован какой-то механизм
OP> поиска информации по нему. Как я уже говорил выше, хорошо, когда
OP> знаешь, что тебе нужно, в этом случае поиск по алфавиту действительно
OP> удобен. А если не знаешь сходу? Вот в этом случае и окажутся полезными
OP> всевозможные указатели на соответствующие разделы файла конфигурации,
OP> либо его секции.
По-моему, перекрёстных ссылок там полно.
Желаю успехов, Oleg!
За сим откланиваюсь, Michael.
... dukelsky (at) aha (dot) ru
--- GoldED+/LNX 1.1.5-b20100314
* Origin: ==<<.f1042.ru.>>== (2:5020/1042)
|
