Looks like a promising feature. Thanks Matteo for proposing this feature!
Best regards Alin ________________________________ Från: Tomek CEDRO <to...@cedro.info> Skickat: den 27 april 2025 22:49 Till: dev@nuttx.apache.org <dev@nuttx.apache.org> Ämne: Re: Documentation tags for boards Very cool start Matteo! Builds and works fine for me :-) Would it be possible to rename "Site Tags" to just "Tags"? :-) Thank you :-) Tomek On Sun, Apr 27, 2025 at 8: 51 PM Matteo Golin <matteo. golin@ gmail. com> wrote: > > Hello everyone, Very cool start Matteo! Builds and works fine for me :-) Would it be possible to rename "Site Tags" to just "Tags"? :-) Thank you :-) Tomek On Sun, Apr 27, 2025 at 8:51 PM Matteo Golin <matteo.go...@gmail.com> wrote: > > Hello everyone, > > I opened a PR here to test out using tags in our docs: > https://urldefense.com/v3/__https://github.com/apache/nuttx/pull/16275__;!!O7_YSHcmd9jp3hj_4dEAcyQ!00sA-EkxUCT6wXreo3756CstdLTmsW8DwB-Ub33S5y5UxSQfCeeWnR5Pz1hZmWN-tnkfO-ER5Ku9AxAOOw$ > 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://urldefense.com/v3/__https://sphinx-tags.readthedocs.io/en/latest/quickstart.html*usage__;Iw!!O7_YSHcmd9jp3hj_4dEAcyQ!00sA-EkxUCT6wXreo3756CstdLTmsW8DwB-Ub33S5y5UxSQfCeeWnR5Pz1hZmWN-tnkfO-ER5KtBke7GJA$ > >> > > >> > 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://urldefense.com/v3/__https://nuttx.apache.org/docs/latest/platforms/xtensa/esp32s3/boards/esp32s3-xiao/index.html__;!!O7_YSHcmd9jp3hj_4dEAcyQ!00sA-EkxUCT6wXreo3756CstdLTmsW8DwB-Ub33S5y5UxSQfCeeWnR5Pz1hZmWN-tnkfO-ER5Kv8hFWKGA$ > >> > > >> > 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, > >> https://urldefense.com/v3/__http://www.tomek.cedro.info__;!!O7_YSHcmd9jp3hj_4dEAcyQ!00sA-EkxUCT6wXreo3756CstdLTmsW8DwB-Ub33S5y5UxSQfCeeWnR5Pz1hZmWN-tnkfO-ER5KtjSb4KNQ$ > >> > > -- CeDeROM, SQ7MHZ, https://urldefense.com/v3/__http://www.tomek.cedro.info__;!!O7_YSHcmd9jp3hj_4dEAcyQ!00sA-EkxUCT6wXreo3756CstdLTmsW8DwB-Ub33S5y5UxSQfCeeWnR5Pz1hZmWN-tnkfO-ER5KtjSb4KNQ$