Hello everyone,

I opened a PR here to test out using tags in our docs:
https://github.com/apache/nuttx/pull/16275
Please leave your feedback!

For now, I've included three types of tags:
- Chip tags to indicate what chip a board uses
- Peripheral tags to indicate supported peripherals (WiFi, Ethernet, etc)
- 'Experimental' tag to indicate experimentally supported boards and
drivers that are still under testing. This should hopefully alleviate some
issues when it's adopted so users can avoid using experimental boards if
they need a stable system.

Let me know what you think or if you have any tag ideas! I'm considering
having architecture tags like it was suggested here, and maybe also adding
some feature tags that aren't necessarily related to peripherals like
"multicore", "SMP", "asymmetric cores", "graphics" (for graphics capable
systems), etc. I also think it might be a good idea to add "stable" tags to
boards which are regularly tested, but that might have to wait until we're
able to really commit to maintaining the stability of those boards.

If this gets accepted I can work on tagging more of the documentation.

Matteo

On Thu, Apr 17, 2025 at 6:12 PM Matteo Golin <matteo.go...@gmail.com> wrote:

> Actually, I was just thinking about supported peripherals/features when I
> thought about this, but I also think having tags for MCUs/chips would be
> really useful! Perhaps even architectures, although I'm not sure if that's
> necessary since all the boards are organized into directories based on
> architecture anyways. I don't think every board needs its own tag since
> each board is unique, it can just be searched by name.
>
> Happy to see that other people would benefit from this feature!
>
> Matteo
>
> On Thu, Apr 17, 2025 at 1:49 PM Tomek CEDRO <to...@cedro.info> wrote:
>
>> Hi Matteo! Very cool idea to have tags in the docs to mark supported
>> features! :-)
>>
>> I would see a list of all available predefined tags somewhere at the
>> end of documentation (tag index) so we know what is out there and not
>> to create new ones, so the search results and markings are coherent.
>>
>> Each board could have its own tag, mcu would have its own mcu, and
>> supported peripherals (i.e. wifi), right?
>>
>> Thanks :-)
>> Tomek
>>
>>
>>
>> On Thu, Apr 17, 2025 at 2:49 AM Matteo Golin <matteo.go...@gmail.com>
>> wrote:
>> >
>> > Hello everyone,
>> >
>> > I am starting a new drone project which I am hoping to use NuttX for,
>> and as part of the project I am looking for NuttX
>> > supported boards that include WiFi support. I was thinking, it might be
>> useful for the NuttX documentation to make use
>> > of a tag system to easily search for features.
>> >
>> > I found this Sphinx extension that allows you to use tags, maybe we
>> could start using it in NuttX's docs:
>> > https://sphinx-tags.readthedocs.io/en/latest/quickstart.html#usage
>> >
>> > This way it would be possible to filter boards by different features,
>> which would be a useful search feature. For
>> > example, the XIAO ESP32S3 has hardware support for WiFi:
>> >
>> https://nuttx.apache.org/docs/latest/platforms/xtensa/esp32s3/boards/esp32s3-xiao/index.html
>> >
>> > But I don't think NuttX implements it yet. If I were able to filter by
>> boards that support WiFi, I wouldn't have to look
>> > up supported boards I'm not familiar with, or read all their
>> documentation pages. I wanted to know what others think;
>> > would this would be worthwhile to add or is it just more work to ensure
>> that documented boards include the proper tags?
>> >
>> > On a side note, if there is anyone who has written WiFi support for a
>> chip in NuttX, please let me know if you have any
>> > tips to get started or if you've happened to write a guide. I might
>> decide to spend some time on adding support for
>> > wireless chips to learn more about it.
>> >
>> > Thanks!
>> >
>> > --
>> > Matteo Golin
>>
>>
>>
>> --
>> CeDeROM, SQ7MHZ, http://www.tomek.cedro.info
>>
>

Reply via email to