> Btw, perhaps we could summarize what documentation pages we are missing.
> GitHub issue would be the best place for this?

The issue with blank pages is here:
https://github.com/apache/nuttx/issues/11081

We probably need a similar issue with pages that need improvement.
Or we could create a separate issue for each not complete page for better
visibility.

The rest of the issues related to documentation can be easily accessed with
the
"Area: Documentation" label:
https://github.com/apache/nuttx/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22Area%3A%20Documentation%22


pt., 7 lis 2025 o 12:50 Alan C. Assis <[email protected]> napisał(a):

> Yes, that is a good idea, I remember Mateusz did it during the process to
> migrate Confluence pages to Doc RST.
>
> This way we can track which pages still need to be created.
>
> If you look at
> https://nuttx.apache.org/docs/latest/applications/index.html
> you will see almost all apps have pages, but almost all are empty pages.
>
> BR,
>
> Alan
>
> On Fri, Nov 7, 2025 at 6:25 AM Michal Lenc <[email protected]> wrote:
>
> > +1 for this, I think the wording of these points is a good compromise.
> >
> > Btw, perhaps we could summarize what documentation pages we are missing.
> > GitHub issue would be the best place for this?
> >
> > Michal
> >
> > On 11/6/25 20:58, Alan C. Assis wrote:
> > > As discussed in [1] we need to improve our Documentation and requesting
> > > Documentation from the author of the new added Features seems to be the
> > > best approach.
> > >
> > > So these are the proposals to be voted:
> > >
> > > - Anyone submitting a new features should write Documentation to it,
> > which
> > > he/she is the author is knows more about that features than other
> people
> > > and could write better Documentation;
> > >
> > > - Anyone adding a new function (or a new resource such as ioctl, etc)
> > > should include it in the existing Documentation; If there is not
> > > Documentation for that Feature/Driver/whatever, then the Reviews should
> > > suggest the contributor to submit a basic page (without forcing him to
> do
> > > it)
> > >
> > > I think these are the key points collected from the previous
> discussion.
> > >
> > > BR,
> > >
> > > Alan
> > >
> > > 1 - https://lists.apache.org/thread/5dklb9r2k9vpl9jwpromdn0lcv3h0985
> > >
> >
> >
>

Reply via email to