Page 3 of 5

Re: KolibriOS Documentation

Posted: Thu May 13, 2010 10:40 pm
by IgorA
Nasarus ты пропустил 1 день
Pterox' DocPack R5. Last Edition: 14.05.2010. История выпусков
.........
R #005 //KOS 0.7.7.0+ //14.05.2010
сегодня 13-е

Re: KolibriOS Documentation

Posted: Thu May 13, 2010 10:53 pm
by Nasarus
IgorA
Нет, все правильно. Просто я живу на Дальнем Востоке, у нас уже 14-ое =D

Re: KolibriOS Documentation

Posted: Fri May 14, 2010 7:35 am
by Nasarus
У меня есть идея относительно DocPack'а. Т.к. в дальнейшем в документации будет пополнятся статьями, иллюстрациями и т.п, предлагаю сделать несколько параллельных вариантов:
1. Для программистов которым не нужны разичные статьи вроде описания программ, настройки системы и т.п., или если просто не нужны свистоперделки - сделать урезанную версию (API, как писать драйвера, программы и т.д.).
2. Для опытных пользователей или для тех, кому не позволяет возможности ПК и кому не нужны различные свистоперделки, тормозящие HTMLv, - оставить только базовые сведения по настройке, установке, версиях + еще что-то :D
3. Совместить п2 и п3 - для тех у кого не позволяет скорость компьютера, интернета, кол-во памяти RAM или HDD, CD, FDD или что у вас там.. :D
4. Ну и собственно полная документация, как-бы вся Wiki в одном архиве, заточенная под HTMLv и содержащая в себе кучу разной инфы.

З.Ы. Ну как вам план? Одобряете? :)
P.S. В дальнейшем можно будет еще и разделить мой DocPack' по языкам (English, Russian)

Re: KolibriOS Documentation

Posted: Fri May 14, 2010 12:42 pm
by Gluk
классная доку) и план хорош

Re: KolibriOS Documentation

Posted: Fri May 14, 2010 2:32 pm
by Nasarus
Gluk
Спс. Стараюсь :lol:

Re: KolibriOS Documentation

Posted: Sun May 16, 2010 7:12 am
by Nasarus
Теперь есть онлайн-версия для того, чтобы не надо было лишний раз качать:
Онлайн-версия

Re: KolibriOS Documentation

Posted: Sun May 16, 2010 2:02 pm
by art_zh
Инфа заметно устарела (навскидку - fn 9 и 62).

Сверяйся с Вики - там более полная, связная и постоянно обновляемая документация.

Re: KolibriOS Documentation

Posted: Sun May 16, 2010 2:24 pm
by Nasarus
Конечно, первым делом доку по API надо обновить, но мне некогда, да и интернет у меня такой, что wiki.kolibrios.org еле грузит =(

Re: KolibriOS Documentation

Posted: Sun May 16, 2010 3:56 pm
by Nasarus
Гм.. Поставил себе в XP текстовый браузер Links, работающий с библиотекой CygWin. Наконец вика читается быстро и нормально :D Стало быть будем синхронизироваться)))

Re: KolibriOS Documentation

Posted: Sat May 29, 2010 5:09 am
by Nasarus
Выпуск R6. Добавлен русский мануал по FASM'у, добавлена справка по работе ядра (aka Kernel/Ru), документация по API ядра синхронизирована с wiki, мелкие исправления.
Pterox' DocPack R6.7z - 449 512 байт

Re: KolibriOS Documentation

Posted: Sat May 29, 2010 12:48 pm
by art_zh
Nasarus,

супер!

Осталось только приклеить доку по библиотекам
[svn=]\programs\develop\libraries\box_lib\trunk\doc[/svn]

Сведений там конечно маловато, но хоть что-то...

Re: KolibriOS Documentation

Posted: Sat May 29, 2010 2:31 pm
by Mario
Докой по библиотекам являются исходники примеров к использованию библиотеки и ответы авторов кода на прямо заданные на форуме вопросы.
Конечно хорошо бы все задокументировать, но например я еще тот писатель, да и времени вечно мало и лень. :lol:

Re: KolibriOS Documentation

Posted: Thu Jun 03, 2010 4:17 pm
by diamond
art_zh wrote:Сверяйся с Вики - там более полная, связная и постоянно обновляемая документация.
Гы-гы-гы. Какая версия ядра указана в функции 18.13 на вики? И это только один пример, а вики целиком есть набор информации, частично верной, частично неверной, частично устаревшей, частично ошибочной.
Следует, кстати, признать, что мой эксперимент с http://wiki.kolibrios.org/wiki/Last_changes позорно провалился.
Mario wrote:Докой по библиотекам являются исходники примеров к использованию библиотеки и ответы авторов кода на прямо заданные на форуме вопросы.
...а докой по сисфункциям являются исходники ядра, примеры программирования и ответы ядерщиков на форуме, ага.

Re: KolibriOS Documentation

Posted: Thu Jun 03, 2010 4:21 pm
by Mario
diamond wrote:
Mario wrote:Докой по библиотекам являются исходники примеров к использованию библиотеки и ответы авторов кода на прямо заданные на форуме вопросы.
...а докой по сисфункциям являются исходники ядра, примеры программирования и ответы ядерщиков на форуме, ага.
А че нет? Все так и есть. :D

Re: KolibriOS Documentation

Posted: Thu Jun 03, 2010 5:08 pm
by art_zh
diamond wrote:
art_zh wrote:Сверяйся с Вики - там более полная, связная и постоянно обновляемая документация.
Гы-гы-гы. Какая версия ядра указана в функции 18.13 на вики?
Та же, что и в оригинале: kernel/trunk/docs/sysfuncs.txt
diamond wrote:И это только один пример, а вики целиком есть набор информации, частично верной, частично неверной, частично устаревшей, частично ошибочной.
А почему бы ее не исправить/обновить, если заметил где-то лажу?
diamond wrote:Следует, кстати, признать, что мой эксперимент с http://wiki.kolibrios.org/wiki/Last_changes позорно провалился.
:?: