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, - оставить только базовые сведения по настройке, установке, версиях + еще что-то
3. Совместить п2 и п3 - для тех у кого не позволяет скорость компьютера, интернета, кол-во памяти RAM или HDD, CD, FDD или что у вас там..
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
Спс. Стараюсь
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. Наконец вика читается быстро и нормально
Стало быть будем синхронизироваться)))
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
Докой по библиотекам являются исходники примеров к использованию библиотеки и ответы авторов кода на прямо заданные на форуме вопросы.
Конечно хорошо бы все задокументировать, но например я еще тот писатель, да и времени вечно мало и лень.
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:Докой по библиотекам являются исходники примеров к использованию библиотеки и ответы авторов кода на прямо заданные на форуме вопросы.
...а докой по сисфункциям являются исходники ядра, примеры программирования и ответы ядерщиков на форуме, ага.
А че нет? Все так и есть.
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:И это только один пример, а вики целиком есть набор информации, частично верной, частично неверной, частично устаревшей, частично ошибочной.
А почему бы ее не исправить/обновить, если заметил где-то лажу?