WifiNINA - Bad links in reference docs

[snoozerman]

Hello All,
I could not find an obvious place where this should be posted I try here. Appologize if wrong.

I think there are some outdated pages for WifiNINA. I got confused by the docs because there appears to be two different "landing" pages for the library.

First (outdated?) is reached by;

1. Goto page https://www.arduino.cc/reference/en/libraries/
2. Click on first category in list "Communication". Takes you to https://www.arduino.cc/reference/en/libraries/category/communication/
3. Click on last item in first list "WifiNINA". Takes you to https://www.arduino.cc/reference/en/libraries/wifinina/.

Is this an outdated page? I searched docs for Server Class method available(). Discovered the link on this pages makes no difference between Server Class method available() and Client Class method available() ! Same path is used for both: https://www.arduino.cc/reference/en/libraries/wifinina/available/

Second (correct?) "landing page" should rater be

1. Starting from same page as in step1 above...
2. Scroll a bit longer down and instead follow the link under heading " MKR WiFi 1010, MKR VIDOR 4000, Arduino NANO 33 IoT and Arduino UNO WiFi Rev.2". Takes you to https://www.arduino.cc/en/Reference/WiFiNINA. This page appears to server same purpose as above but with correct links.

Here, I am correctly directed to

• https://www.arduino.cc/en/Reference/WiFiNINAServerAvailable or
• https://www.arduino.cc/en/Reference/WiFiNINAClientAvailable

Perhaps this should be updated?

Is there any other place I should write my feedback to, please feel free to tell me!

[in0]

@snoozerman

Is this an outdated page?

This is actually the modern one. Arduino is in the process of migrating all the library reference pages from the previous "PmWiki" CMS to Markdown source files hosted on GitHub in the same repository as the library firmware code:

Add docs

The library reference pages are then generated from that content.

Unfortunately, it seems that generation system bases the page names and/or the links on the heading text alone. So if there are two available() headings, then both the reference links point to the same page.

I see the same problem several other places.

@snoozerman

Takes you to WiFiNINA - Arduino Reference. This page appears to server same purpose as above but with correct links.

This is the old PmWiki-based page. The content at https://github.com/arduino-libraries/WiFiNINA/tree/master/docs is a copy/paste of the content from that page.

@snoozerman

Is there any other place I should write my feedback to, please feel free to tell me!

Since the generation system code is not in a public repository, I think the best way to bring this bug to the attention of the people at Arduino who are able to fix it is reporting it through this contact form:

https://www.arduino.cc/en/contact-us

Thanks!