Board.KolibriOS.org

Официальный форум KolibriOS
Текущее время: Ср ноя 14, 2018 5:56 am

Часовой пояс: UTC+03:00




Начать новую тему  Ответить на тему  [ 31 сообщение ]  На страницу 1 2 3 След.

В каком формате Вы хотели бы видеть документацию по KolibriOS?
txt 20%  20%  [ 13 ]
html 42%  42%  [ 27 ]
chm 22%  22%  [ 14 ]
rtf 6%  6%  [ 4 ]
Другой 9%  9%  [ 6 ]
Всего голосов: 64
Автор Сообщение
 Заголовок сообщения: Документация для KolibriOS
СообщениеДобавлено: Сб мар 11, 2006 4:30 pm 
Не в сети

Зарегистрирован: Пт янв 06, 2006 6:05 am
Сообщения: 102
Уважаемые разработчики!

В каком формате Вы хотели-бы видеть документацию для KolibriOS

Выскажите здесь ваши мнения по этому поводу.

_________________
Изображение


Вернуться к началу
 Заголовок сообщения:
СообщениеДобавлено: Вс мар 12, 2006 4:47 pm 
HTML only. Ostal'noe govno. A chem ya chm v Linuxe smotret' budu? Vse viewery CHM pod Linux - govno.


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Пн мар 13, 2006 5:03 pm 
.chm, а .hlp еще чуть лучше. Чистый html плох - нет быстрого поиска по указателю, которым я в основном и пользуюсь (набираешь первые несколько букв функции win api - и справка по ней уже перед глазами).


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Пн мар 13, 2006 9:29 pm 
Halyavin:
Ne zabyvay o userah drugih OS.


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Ср мар 15, 2006 9:40 pm 
3 варианта:
1. pdf - кросплатформенность
2. самописная смотрелка своего формата (бред, но сейчас модно)
3. latex/lyx и экспортируй во что хочешь, собственно я за этот вариант. могу сверстать если всем лень текущию версию в латекс


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Чт мар 16, 2006 6:25 pm 
Не в сети
Аватара пользователя

Зарегистрирован: Чт окт 13, 2005 12:00 pm
Сообщения: 299
pdf очень резонно


Вернуться к началу
 Заголовок сообщения:
СообщениеДобавлено: Чт мар 16, 2006 6:28 pm 
Не в сети
Аватара пользователя

Зарегистрирован: Чт окт 13, 2005 12:00 pm
Сообщения: 299
соображения такие, пдф конвертится из опен офисс и из мастдай офисс, все легко набирать и вставлять, можно делать гиперссылки, формулы и т.д.


Вернуться к началу
 Заголовок сообщения:
СообщениеДобавлено: Чт мар 16, 2006 7:02 pm 
Не в сети

Зарегистрирован: Пт янв 06, 2006 6:05 am
Сообщения: 102
to Camper - см. раздел Разное -> Документация
Я почти сразу в pdf перевёл через ABC Amber Converter.

_________________
Изображение


Вернуться к началу
 Заголовок сообщения:
СообщениеДобавлено: Сб мар 18, 2006 12:21 am 
camper
Я не совсем согласен - он часто тянет с собой шрифты в теле. По этому часто его вес получается достаточно тяжелый.
Имхо html и txt самые доступные форматы, для любой системы - даже ДОС.
Колибри конечно пока не поддерживает html, но это вопрос времени. Зато TXT и RTF уже можно смотреть.


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Сб мар 18, 2006 4:52 pm 
Не в сети

Зарегистрирован: Вс июн 19, 2005 7:08 pm
Сообщения: 41
IMHO всю документация надо разделить на Руководство пользователя и Руководство разработчика. Все статьи включить либо в первый, либо второй документ. Будет удобно скачать всю докуменацию сразу, чем отдельно искать статьи в разных местах.


Вернуться к началу
 Заголовок сообщения:
СообщениеДобавлено: Чт мар 23, 2006 1:31 pm 
А мне думается, что нужно документацию переводить в тот формат, который поддерживается многими ОС.Это имхо: HTML,txt и rtf.


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Чт авг 31, 2006 1:41 pm 
Читать, блин, особо не стал посты... тороплюсь, хочу сказать, что в HTML весьма неплохо и кросс-платформенно, хотя и CHM можно читать в линухе. А про поиск - можно поиск на JavaScript замутить, есть даже инструменты-генераторы. А еще можно в PDF - вообще неплохая штука.


Вернуться к началу
   
 Заголовок сообщения:
СообщениеДобавлено: Чт авг 31, 2006 7:31 pm 
Не в сети

Зарегистрирован: Пн апр 10, 2006 7:22 am
Сообщения: 76
Кстати, новый формат - OpenDocument
http://www.odfalliance.org
http://en.wikipedia.org/wiki/OpenDocument_technical_specification
http://books.evc-cit.info/odbook/book.html


Вернуться к началу
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Вс окт 07, 2007 12:49 pm 
Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал :). Пришлось переписывать заново, оно и к лучшему...

Смысл в чем. Ни в коем случае нельзя делать доки в одном формате....Это по личному опыту (занимаюсь этим). Необходимо (именно необходимо) выбрать как минимум ДВА формата, причем широкораспространенные, и один из них выбрать из разряда "обычным_юзверем_не_ковыряемый".....
Это поможет избежать многих мелких неприятностей, особенно когда ось станет более-менее зрелым продуктом.
Тут наиболее банальная связка ХТМЛ-Дежавю....
В доке ОБЯЗАТЕЛЬНО должен в самом начале указываться релиз системы (в каждом файле) и т.д. и т.п....
Доки для юзверей ОБЯЗАТЕЛЬНО должны быть отделенными от док для кодеров и быть предельно простыми и исключать двойное толкование (это самое трудное... бывает такого наслушаешься, что волосы дыбом не только на голове)...

Хороший пример доки для начинающего юзверя (только не кидать в меня камнями) книжка от Win95. Самое основное, с картинками (типа комиксы) и FAQ...


В принципе, если запущу на своем агрегате (испытательном), и разберусь в оси,то посмотрю... бог даст - приведу к "корпоративному" виду... но это не раньше конца ноября :(..

P.S. Надо прежде всего четко сформулировать политику составления манов...


Вернуться к началу
   
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Вс окт 07, 2007 2:10 pm 
Не в сети
Designer
Аватара пользователя

Зарегистрирован: Чт янв 25, 2007 3:33 pm
Сообщения: 4878
Документация предполагается в ХТМЛ с ограниченным числом тегов.

Та даже пофиг на формат, главное прога, которая бы умела читать этот формат. А её нет!
(Тайнипад неплох, но не для серьёзной документации - например, должны быть хотя бы гиперссылки и кнопочки туда\назад)

_________________
Через тернии к звездам


Вернуться к началу
Показать сообщения за:  Поле сортировки  
Начать новую тему  Ответить на тему  [ 31 сообщение ]  На страницу 1 2 3 След.

Часовой пояс: UTC+03:00


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и 1 гость


Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

Найти:
Перейти:  
Создано на основе phpBB® Forum Software © phpBB Limited
Русская поддержка phpBB