not yet, we are busy preparing the Chinese documentation.

On Tue, Apr 25, 2023 at 10:27 PM Alan C. Assis <acas...@gmail.com> wrote:

> 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