Board.KolibriOS.org

Официальный форум KolibriOS
Текущее время: Вт ноя 20, 2018 5:23 pm

Часовой пояс: 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
Автор Сообщение
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Вс окт 07, 2007 2:14 pm 
HORROR
Цитата:
Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал

Я вот думаю купить ИБП на 700W. Очень редко, но все-таки отрубают сеть, и по закону подлости это случается в самый неподходящий момент.
Цитата:
и один из них выбрать из разряда "обычным_юзверем_не_ковыряемый"

Цитата:
Тут наиболее банальная связка ХТМЛ-Дежавю

ИМХО PDF тоже подойдет, ЕМНИП там можно устанавливать защиту от редактирования, конечно, сломать можно все, но все же.
Цитата:
Доки для юзверей ОБЯЗАТЕЛЬНО должны быть отделенными от док для кодеров и быть предельно простыми и исключать двойное толкование

Доки для пользователей обычно пишут другие более продвинутые пользователи, программистам уже тяжело выражаться, не забираясь в дебри. Когда я пытаюсь объяснять на пальцах, юзеры обычно обижаются - типа что-же мы же не настолько тупые чтобы нам ТАК объясняли, перехожу на обычный свой язык - лица становятся чистыми и светлыми, одухотворенными... не испорченными следами интеллекта. :mrgreen:
Цитата:
Хороший пример доки для начинающего юзверя (только не кидать в меня камнями) книжка от Win95. Самое основное, с картинками (типа комиксы) и FAQ...

А зачем кидаться то? Большая часть компьютерщиков так начинала, хоть и ни за какие коврижки теперь не признаются. (Типа родились уже умными)
Я начинал с Бейсика и Фокала на БК-0010, книжка по Win95 мне попалась в руки уже, после того как я ковырял свой первый PC. А до этого был Фигурнов, зачитанный до дыр. А более трамплинистой книжки, чем Жаров "Железо IBM PC" мне больше в жизни не попадалось - столько информации в доступной форме я больше не видел. Разумеется, это все не руководства для программистов, но без них невозможно начать более серьезной работы.
Цитата:
P.S. Надо прежде всего четко сформулировать политику составления манов

Может ты, и займешься этим? Было бы хорошо.
Удачи.


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

Зарегистрирован: Чт мар 01, 2007 7:57 pm
Сообщения: 835
HORROR писал(а):
Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал :)

Есть хорошее лекарство - это браузер Firefox 2
Он восстанавливает аварийно прерванную сессию, включая введённый тобой текст ;)

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


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

Зарегистрирован: Чт мар 01, 2007 7:57 pm
Сообщения: 835
Mario97: где можно взять всю эту литературу?

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


Вернуться к началу
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Вс окт 07, 2007 6:12 pm 
Атауальпа
Библиотека, знакомые, Интернет http://google.ru/


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

Зарегистрирован: Чт мар 01, 2007 7:57 pm
Сообщения: 835
Спасибоя, я поищу. Возможно, эта литература поможет мне начать что-то делать.

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


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

Зарегистрирован: Чт мар 01, 2007 4:16 pm
Сообщения: 426
Я проголосовал за chm, но это, в принципе, тот же html, только собранный в один файл.
Ограниченный просмотрщик html без валидации вполне можно сделать. Только лучше ориентированить на стандарт xhtml, парсить xml значительно проще. Разве что возникнет проблема со шрифтами, как всегда.

..bw


Вернуться к началу
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Пн окт 08, 2007 9:36 am 
Не в сети

Зарегистрирован: Ср фев 21, 2007 3:03 pm
Сообщения: 188
А по-моему срать (извиняюсь за слово) какой формат документации. Самое главное чтоб документация была толковая, а остальное не важно. При желании из простого хтмл делается и chm и pdf и txt, конвертеров, благо, хватает. Да и мозги присутствуют :) Действительно, нашелся бы человек, который сможет донести это до людей. Я согласен с Mario79, у меня такая же проблема, я не могу найти эту грань, либо получается объяснение для даунов, либо для себе подобных.

зы. ребят, знаете чего не хватает, документации для разработчиков ядра.


Вернуться к началу
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Пн окт 08, 2007 9:49 am 
k@sTIg@r
ИМХО исходники ядра в каком то смысле самии являются документацией - все процедуры мы обзывавем учитывая их назначение, а прокомментировать каждую строку кода нереально.


Вернуться к началу
   
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Пн окт 08, 2007 11:08 am 
Не в сети

Зарегистрирован: Ср фев 21, 2007 3:03 pm
Сообщения: 188
> все процедуры мы обзывавем учитывая их назначение
Ух, я бы тут поспорил :) Правда, щас дело обстоит куда лучше, чем когда я увидел колибри в первый раз. Когда драйвер мыши писал, особо нравились mouse_count, а также win_pos, win_stack и остальные... Пока не посмотришь их использование, трудновато догадаться в каком виде они хранятся и как используются. Это касается и некоторых функций. Никого не хочу обидеть ;) ибо сам такой же...

Допустим, опять же драйвер мыши. Есть несколько файлов связаных с мышью. В каком искать то что нужно мне. Приходится все пересматривать. И т.д. Вам легко, вы мсходники ядра знаете, знаете где что лежит. Новичкам сложнее. Но это было всего-лишь предложение...


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

Зарегистрирован: Чт мар 01, 2007 4:16 pm
Сообщения: 426
В исходниках очень трудно разобраться. Нужно как минимум комментировать каждый файл/модуль и желательно структуры, а так же функции и др. ключевые моменты.

..bw


Вернуться к началу
 Заголовок сообщения: Re: Документация для KolibriOS
СообщениеДобавлено: Ср окт 10, 2007 3:58 pm 
По поводу исходников... подрабатывал я по студенчеству на мотороллу..... кодером. Ходил дядька - менеджер и за исходники драл нещадно:
- за использование слэнга в коментариях, сокращений
- за более чем ДВЕ строки кода подрят без комментариев (проверяла прога-анвлизатор)
- за то, что комментариев менее 17% от общего количества знаков, причем знаки препинания и спецсимволы не учитывались(проверяла прога-анвлизатор)
- за то, что комментарий невнятен.

Короче всю плеш проел... месяц привыкал....зато потом не раз благодарил , когда в чужих исходниках смотрел..

Что косается "Доки для чайников"... я ужо говорил - ближе к концу ноября.
Тут надо самому для начала попробывать всё,
подомогаться разработчиков,
грязно поприставать к тому что есть....
а потом показать какомунить подростку и по результатам...начать все заново...:)


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

Зарегистрирован: Чт сен 20, 2007 8:09 pm
Сообщения: 96
Вотпо поводу комментов согласен. У меня шерсть дыбом стоит, т.к. разобраться не получается...


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

Зарегистрирован: Пн ноя 28, 2005 8:00 pm
Сообщения: 1601
Все вопросы по исходникам ядра можно задавать мне (по мылу, или личным сообщением, или ещё как-нибудь), я в них довольно хорошо разбираюсь.

_________________
Ушёл к умным, знающим и культурным людям.


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

Зарегистрирован: Пн апр 16, 2007 6:38 pm
Сообщения: 1222
тогда предлагаю тебе сохранять свои ответы на вопросы, тогда в итоге наберется документация по ядру)

_________________
И мы уже давно не пешки,
Мы пули, мы орлы, и решки!
Война ютит бинарный код,
Умри, или иди вперед!


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

Зарегистрирован: Чт мар 01, 2007 7:57 pm
Сообщения: 835
У меня есть такое замечание.
В исходниках часто пишут:
Код:
include '..\..\..\macros.inc'

Виндовый Fasm это понимает, а Fasm для Kolibri ругается.
У меня вчера с этим были проблемы, когда в Kolibri компилировал Stackcfg, пришлось править на
Код:
include 'macros.inc'

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


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

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


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

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


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

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