Board.KolibriOS.org

Official KolibriOS board
It is currently Thu Dec 03, 2020 4:28 am

All times are UTC+03:00




Post new topic  Reply to topic  [ 4 posts ] 
Author Message
PostPosted: Mon Jul 13, 2020 2:52 pm 
Offline
User avatar

Joined: Mon Apr 06, 2020 1:09 pm
Posts: 57
Решил написать полный справочник (которого так не хватает) по исходному коду ядра Колибри, выкладываю то, что получилось на данный момент.
Пока идея документа простая, для каждого файла исходного кода описать, какие функции и структуры данных в нем реализуются, как они работают и зачем они нужны.
Знаю, в Вики подробно описана концепция работы ядра, но к сожалению она не описывает большинство внутренних функций и структур ядра, а только самые самые основные. Также стоит сказать, что некоторые участки ядра неплохо прокомментированы в самом коде, в то время как попадаются и места где комментарии полностью отсутствуют. В результате, я начал писать справочник.
P.S. в файле в некоторых местах встречаются пометки TODO вместо описаний а также пока не рассмотрены многие файлы кода, было бы очень хорошо если участники нашего сообщества, которые имеют более глубокие познания во внутренностях ядра, дополнили бы данный документ :D


Attachments:
kolibri_kernel_sources_map_v0.0.1.txt [31.63 KiB]
Downloaded 115 times

_________________
The best way to predict the future is to create it.
Top
   
PostPosted: Tue Jul 14, 2020 1:57 am 
Offline
Mentor
User avatar

Joined: Mon Oct 19, 2009 10:58 am
Posts: 577
Documentation is vital for KolibriOS development and your effort is very appreciated.

Some thoughts on this:
  1. There is no reason to keep description of a function in a separate file from its body.
  2. Same for more high-level logic. CleverMouse set a quite high standard of documentation that I see no reason to not follow (except lazyness of course).
  3. May be it's time to proceed with discussion of in-code documentation?


Top
   
PostPosted: Tue Jul 14, 2020 4:01 pm 
Offline
User avatar

Joined: Mon Apr 06, 2020 1:09 pm
Posts: 57
dunkaist wrote:
Documentation is vital for KolibriOS development and your effort is very appreciated.

Some thoughts on this:
  1. There is no reason to keep description of a function in a separate file from its body.
  2. Same for more high-level logic. CleverMouse set a quite high standard of documentation that I see no reason to not follow (except lazyness of course).
  3. May be it's time to proceed with discussion of in-code documentation?

1) I think it is convenient to have descriptions of all function in one place along with the comments in code. For example to overview the kernel structure its quite easier to learn documentation in one file (maybe with internal hyperlinks), than open many many tabs in text editor. Also, maybe Ill add more detailed explanations on how does some things in the kernel work, so document above can become rather a book than only documentation.
2) You mean http://wiki.kolibrios.org/wiki/Style/ru ? Yes, we need to translate existing russian comments in the kernel and add missing, following one standart.
3) Yes it is good idea to add possibility to automatically make documentation files from in-code comments. Writing python script that grabs function decriptions from source code file, using regexps, would be not bad and simple solution..

_________________
The best way to predict the future is to create it.


Top
   
PostPosted: Sun Nov 08, 2020 2:38 am 
Offline
User avatar

Joined: Mon Apr 06, 2020 1:09 pm
Posts: 57
Here is the 0.0.2 version, ive added descriptions on some things and how they work. Now still only in russian, but in future I'll translate it in english too.


Attachments:
kolibri_kernel_sources_map_v0.0.2.txt [37.62 KiB]
Downloaded 11 times

_________________
The best way to predict the future is to create it.
Top
   
Display posts from previous:  Sort by  
Post new topic  Reply to topic  [ 4 posts ] 

All times are UTC+03:00


Who is online

Users browsing this forum: Google [Bot] and 2 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Limited