Hi all, Right now, Documentation is in the main nuttx repository [1].
However, some of the Documentation there pertains to the nuttx-apps repository. One current example is PR #16665 in nuttx repo, which is documenting the new Xedge example located in the nuttx-apps repo. I think it's a little bit messy to have documentation in nuttx repo for things that belong in nuttx-apps repo. One disadvantage is that repos can get out-of-sync. Another disadvantage is that NuttX users are not required to use nuttx-apps repo. They can supply their own. But, they will have Documentation about things in nuttx-apps repo. That could be confusing because they might see something in Documentation but will not be able to find it. I suggest to create a Documentation in nuttx-apps repo and move all apps-related docs there. So nuttx/Documentation will only document things in the nuttx repo, and nuttx-apps/Documentation will only document things in the nuttx-apps repo. If we do this refactoring, it will mean that the website will need an update also, to pull docs from both sources (nuttx/Documentation and nuttx-apps/Documentation). Thoughts? [1] https://github.com/apache/nuttx [2] https://github.com/apache/nuttx/pull/16665 [3] https://github.com/apache/nuttx-apps/pull/3120 Cheers, Nathan
