Documentation localisation broken ?

I was searching for the doc for analogRead() to share in a forum's answer.

Google pointed me to

which is in French since my default language for the browser was French

at the top of the page there is a popup to select another language

and if I pick English

the URL turns into

https://docs.arduino.cc/language-reference/en/functions/analog-io/analogread/

and it's broken, I get

This XML file does not appear to have any style information associated with it. The document tree is shown below.
<Error>
<Code>AccessDenied</Code>
<Message>Access Denied</Message>
<RequestId>B9X415YQ753KR68Q</RequestId>
<HostId>
Nbm4UGxVMM0WZ71gNu7HwgusIAG9RoeLCCv4pfbRsSvQ15ayQKiMgU+Llt2Gk5LbKLKwpMDB/uU=
</HostId>
</Error>

(it does not work with the other languages either - just French is fine)

Same here, for italian. The dropdown says 3 more languages are available:

but any choice returns that XML error.

It looks like the various language pages aren't correctly referenced from that dropdown.
IMHO it should be removed from the pages until corrected.

This is a working link:
https://docs.arduino.cc/language-reference/en/functions/analog-io/analogRead/

The only difference is the capital 'R' in the word analogRead.

Update: I think it looks like those Arduino reference pages has been completely moved from there, meaning those "old" pages indexed by Google are just a remnant and should not be used. I say this because the language reference (multi-lingual) should be accessed using this URL and not from the first one:

https:// docs.arduino.cc/language-reference/

Just note they are "physically" different pages, because this is how the analogRead() from J-M-L looks:

and this is the "good one", opened from the main new Arduino Docs page:

if I go to https://www.arduino.cc and enter analogRead in the search box at the top left

and pick the first entry I get there

and if I click on the first box I'm routed to https://docs.arduino.cc/en/functions/analog-io/analogRead?queryID=undefinedwhich looks like this

so it seems something is broken somewhere ...

And to add to the mystery, I got this

French and English mixed up ... ("Frenglish" ?)

Link:
https://www.arduino.cc/reference/fr/language/functions/digital-io/digitalread/

:wink:

Edit: And when I choose a different language e.g. English it goes to

https://docs.arduino.cc/language-reference/en/functions/digital-io/digitalread/

Let's see if someone from the Arduino team catches that thread.

1 Like

It's been broken like this for maybe ten days or more. I opened a thread two months ago about how there are two doc sites backed by two repos, and I guess that is in the process of being "resolved" now.

That only makes more pressing the issue: that the links to edit the content under "Suggest changes" at the bottom of the page like for analogRead

all return 404, at least for the Language Reference.

@pert - is that being worked on ?

It’s useful to post links to the documentation when helping out newbies and of course overall for anyone working with the Arduino APIs

Right, so I started using this method: instead of using Google (as it looks like having indexed old-style pages) just always start from:
https:// docs.arduino.cc/language-reference/
then search there the topic you need and share the resulting (working) link.

@docdoc

Wrong place to start :smiley: How will you find the documentation for libraries? Yesterday I was looking for the SD library documentation and had to use google.

PS Thanks for your reply, I've now figured out how to get from the language reference (which I had) to the library "reference".

Yes, the links to the reference pages are broken!!!!! Getting info about for Serial or println in the reference library does not work. Please, fix this!!! I need to explain my students how to browse the arduino.cc site.