Hi Tomek,

Some years ago Matias Nitsche (AKA v0id / protobits) started the
creation of a NuttX book, documenting many of internal OS functions.

But after some time he gave up, because he realized that NuttX is a
movable target. Same happens to Linux (although currently I think
Linux is more stable).

See what happened to Linux Device Drivers from Alessandro Rubini,
although the book still useful and relevant, many Linux functions and
subsystems features described in the book doesn't exist anymore.

So, to user point of view the best book about NuttX is any book about
POSIX and the best "book" for NuttX kernel developers is the source
code itself.

BR,

Alan

On 4/25/23, Tomek CEDRO <to...@cedro.info> wrote:
> Hello world :-)
>
> I was on a trip recently (and it happens quite often) so I was looking
> for a PDF version of NuttX Documentation, kind of Handbook, but I did
> not find one.
>
> I got used to PDF Handbook style because it is all-in-one approach
> that is also easily available and searchable offline.
>
> As I am getting into details and reading the docs, so I can help this part
> :-)
>
> I would like to know what is the current and past approach to the
> documentation, to plan the work and align the tasks (with other people
> working on the documentation?). What is the future preferred way of
> documentation? git+documentation? (c)wiki?
>
> I know there is a doc part on the website that is generated from the
> main repository Documentation/ location. This part seems to need some
> improvement (looks a bit like incomplete copy-paste?) :-)
>
> I know there is a CWIKI. I know there was some bigger documentation
> before..?
>
> It would be best to have HTML and PDF documentation (maybe other
> formats too) in a form of "Handbook" (all-in-one-place + searchable +
> offline). This Handbook could be also provided in a form of e-book for
> free and maybe some pay-as-you-want basis to support the project. This
> would be also probably the first point of contact with the project for
> the newcomers.
>
> As a reference documentation I could point to:
> 1. https://docs.freebsd.org/en/books/handbook/
> 2. https://kivy.org/doc/stable/
>
> Please let me know what you think folks :-)
> Tomek
>
> --
> CeDeROM, SQ7MHZ, http://www.tomek.cedro.info
>

Reply via email to