Board.KolibriOS.org

HORROR

Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал

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

и один из них выбрать из разряда "обычным_юзверем_не_ковыряемый"

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

ИМХО PDF тоже подойдет, ЕМНИП там можно устанавливать защиту от редактирования, конечно, сломать можно все, но все же.

Доки для юзверей ОБЯЗАТЕЛЬНО должны быть отделенными от док для кодеров и быть предельно простыми и исключать двойное толкование

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

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

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

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

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

HORROR wrote:Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал

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

Mario97: где можно взять всю эту литературу?

Атауальпа
Библиотека, знакомые, Интернет http://google.ru/

Спасибоя, я поищу. Возможно, эта литература поможет мне начать что-то делать.

Я проголосовал за chm, но это, в принципе, тот же html, только собранный в один файл.
Ограниченный просмотрщик html без валидации вполне можно сделать. Только лучше ориентированить на стандарт xhtml, парсить xml значительно проще. Разве что возникнет проблема со шрифтами, как всегда.

..bw

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

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

k@sTIg@r
ИМХО исходники ядра в каком то смысле самии являются документацией - все процедуры мы обзывавем учитывая их назначение, а прокомментировать каждую строку кода нереально.

> все процедуры мы обзывавем учитывая их назначение
Ух, я бы тут поспорил Правда, щас дело обстоит куда лучше, чем когда я увидел колибри в первый раз. Когда драйвер мыши писал, особо нравились mouse_count, а также win_pos, win_stack и остальные... Пока не посмотришь их использование, трудновато догадаться в каком виде они хранятся и как используются. Это касается и некоторых функций. Никого не хочу обидеть ибо сам такой же...

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

В исходниках очень трудно разобраться. Нужно как минимум комментировать каждый файл/модуль и желательно структуры, а так же функции и др. ключевые моменты.

..bw

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

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

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

Вотпо поводу комментов согласен. У меня шерсть дыбом стоит, т.к. разобраться не получается...

Все вопросы по исходникам ядра можно задавать мне (по мылу, или личным сообщением, или ещё как-нибудь), я в них довольно хорошо разбираюсь.

тогда предлагаю тебе сохранять свои ответы на вопросы, тогда в итоге наберется документация по ядру)

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