новая дока по конфигу - временная тема

piroJOKE · Чт янв 10, 2008 7:45 pm

Г-да, вот наваял писульку. Зацените плз, можем ли мы этим заменить нашу доку по конфигу в FAQе, или всё еще - хило?

flame31 · Чт янв 10, 2008 8:28 pm

открылось в ворде) и комп повис секунд на 10 ^_^
если сравнить два дока, то новый более удобный, и прост для понимания...имхо)

Сообщение **4epT** » Чт янв 10, 2008 9:34 pm

вкусная штучка, ням

Чт янв 10, 2008 9:42 pm

теперь это всё в нхтмл вид привести и со ссылочками и раскрывающимися списками.
поискать недостающие параметры, такие как итемстайкаутонью, хотя они теперь глючные как оказалось.

piroJOKE · Чт янв 10, 2008 10:06 pm

Я даже хз насчет хтмл-а. Грешным делом думал ваще .pdf сделать.

Добавлено спустя 11 минут 19 секунд:

Click писал(а):поискать недостающие параметры, такие как (...)

Некоторых вещей кстати нет в мануале. Пытался заценить по коду ОК, как же они работают.

Чт янв 10, 2008 10:31 pm

ну в хтмл-ку могу и я сделать, ты ж сможешь её на сервер кинуть по это адресу manual.htm

Добавлено спустя 2 минуты 31 секунду:

хотя не сюда надо а именно на мануал по конфигу

Пт янв 11, 2008 11:42 am

piroJOKE
Почитал. Не для нУбов. Совсем оцтой если чесно.

piroJOKE · Пт янв 11, 2008 11:48 am

kLabMouse
чиво именно так?

Пт янв 11, 2008 1:11 pm

piroJOKE
Примеров как-бы НЕТ.
Правил заполнения полей то-же НЕТ.
Правил создания, копирования блоков НЕТ.
Короче. НЕКАТИТ!

piroJOKE · Пт янв 11, 2008 1:19 pm

kLabMouse
Ога, это я понимаю.

Это как бы будет отдельно. Я как раз думаю, под каким соусом это подавать, в частности понятие диапазонов и примеры - в одной куче, или по отдельности.

Добавлено спустя 4 минуты 46 секунд:

Апдейт. На этот раз формат файла .pdf (нужен Acrobat Reader, а еще лучше FoxIt - юзаем Гуглю).

По делу - серым цветом затенены редко используемые опции, чтобы не забивать новичкам мозги ерундой.

Сообщение **4epT** » Пт янв 11, 2008 1:28 pm

pJ, чтоб сильно не ломать голову разбором кода коры, в файде readme.txt всё же инога пишется краткое описалово новой опции.

Click, я тоже за html-ку, т.к. WX её может читать и выдавать юзверям подсказки (как сделано в новом интерфейсе). Тока если будешь оформлять, то переговори со мной, т.к. там везде (при описании каждой опции) нужно соблюдать один синтаксис, чтобы потом эту html-ку скушал regexp!

pJ я котегорически против pdf-ки, так так с неё нюбам трудно будет что-то копи-паст, или для это как раз и pdf'ишь?

piroJOKE · Пт янв 11, 2008 1:37 pm

Насчет формата, было бы оптимальным сбацать это в wiki и/или в BB-кодах форума.
Но! Обьем файла велик, а визуального люцкого редактора под это у мну нед, а париться с копи-пастом кодов или долбаным "мега-редактором" phpBB ваще нет желания никакого.

Кроме того, я не уверен, что тот же bb-код позволит сделать человеческое оформление - отступы, таблицы, и т.п. А без них дока хреново читабельна.

Насчет копи-паста - это ж незащищенный pdf, из него копировать можно. Правда, переносы строк херятся. Но ведь это не примеры, 4орт, тут даже и нечего копировать. Это обзор, для ознакомления, и всё.

DeniZka · Пт янв 18, 2008 9:28 pm

Нелицеприятно. Че-то с цветами надо делать.
Поменьше количество, повыше контрастность.

Да и ваще PDF - это немного неудобно. Даже .chm лучше был бы.

piroJOKE · Пт янв 18, 2008 9:32 pm

Если честно, меня больше пока волнует контент.

А с форматом публикации да... непонятка, сам в раздумьях.

Сообщение **4epT** » Пн мар 10, 2008 4:26 pm

pJ, нада бы обусловиться в определениях..

Дисконнект и релог это я думаю одно и тоже, т.е. мы на время отключаемся от сервака..

так вот я про avoidGM_near у тебя в боек написано, что 4 - это релог.. однако это респаун (т.е. летим к кафре..)