os-k/docs/Documentation

#=----------------------------------------------------------------------------=#
#                          OS on Kaleid Documentation                          #
#                                                                              #
#   Desc:   Summary and some description                                       #
#                                                                              #
#                                                                              #
#   Copyright © 2018-2020 The OS/K Team                                        #
#                                                                              #
#   Permission is granted to copy, distribute and/or modify this               #
#   document under the terms of the GNU Free Documentation License,            #
#   Version 1.3 or any later version published by the Free Software            #
#   Foundation; with no Invariant Sections, no Front-Cover Texts, and          #
#   no Back-Cover Texts.  A copy of the license is included in the             #
#   file entitled "COPYING.GFDL"                                               #
#=----------------------------------------------------------------------------=#


    This `docs` folder is the root of the OS/K (OS on Kaleid) technical
documentation, whose goals are to explain, describe and a bit formalize the main
principles of our project. As written in the header of each file, we release
this documentation under the terms of the GFDL.


    This documentation is divided between two main sections :

    - The kernel loader, in the `docs/boot` folder, which describes the
technical features of the source code located under the `boot` folder.

    - The kaleid code base, in the `docs/kaleid` folder, which describes the
source code of the kernel drivers, the kernel itself, the buffer library and the
C standard library, respectively located under the `kaleid/drivers`,
`kaleid/kernel`, `kaleid/libbuf`, `kaleid/libc` folders.

    Under these directories, each file represents a terminal source code
subfolder. For example : `docs/kaleid/kernel/io` file describes the
`kaleid/kernel/io` folder that contains C source files.

If a non terminal subfolder is to be described, a description file can be
created by creating a file with the name of the folder, followed by a ".desc"
extension, inside this folder.