On 4/25/23, Alan C. Assis <acas...@gmail.com> wrote:
> On 4/25/23, Gregory Nutt <spudan...@gmail.com> wrote:
>>
>>> Yes, using the Documentation/ as base to create a book is a good idea,
>>> but it should focus on "OS Components" and "API Reference".
>>
>> I don't think that the documentation should be limited to simple HowTo
>> and WhatIs documentation.  I think it should have some technical meat
>> too!  Like explanations of how things work and why they work that way:
>> Theory of Operation documents.
>>
>> I really like Zephyr's Documentation, for example:
>> https://docs.zephyrproject.org/latest/index.html  .  There is quite a
>> bit of meat there; something for everyone.
>>
>
> No, I meant the opposite, the Documentation/ is mostly focused on
> Installations, HowTos, etc, it is better to be more technical.
> Currently only "OS Components" and "API Reference" fit this criteria.
>
> I think our online Documentation is evolving slowly but it is getting
> a better shape, the Zephyr documentation you cited is better organized
> and reach more features. We can walk on that direction.
>
> It seems that their "PDF Handbook" is also based on their online
> Documentation: https://docs.zephyrproject.org/2.7.4/zephyr.pdf
>
> Question: How we can do better, even with smaller team / resources?
> Ideas? ChatGPT is not an option here :-D
>

Replying myself after seen confluence pages (like
https://cwiki.apache.org/confluence/display/NUTTX/Memory+Configurations)

We need some task force to move Confluence documentations to Documentation/

Xiang Xiao: about that guy that you said Xiaomi was planing to
contract to help us with Documentation, do you have some news?

BR,

Alan

Reply via email to