Apparently the online reference has been reorganized but the information is still there.
Only still there in an obscure orphan page that will be deleted as soon as someone from the website team gets the time. In the real Arduino Language Reference, the information is certainly not still there:
https://www.arduino.cc/reference/en/While this is not the best way to document this
The lead technical writer at Arduino has this to say about that text:
https://github.com/arduino/reference-en/issues/476#issuecomment-460056507I will investigate why we have this "The elements of Arduino (C++) code." sentence that is not how it should be.
My understanding is that it's their intent to remove the "(C++)" from that text.
they are certainly trying by reorganizing the reference.
There was no reorganization of the reference. What happened is a few years ago Arduino created an awesome new system where the content of the Arduino Language Reference is stored in a GitHub repository as asciidoc files so that anyone can contribute to it by submitting pull requests to that repository. The Arduino Language Reference web pages are automatically generated from that content. It wasn't a reorganization, it was just a change in the way the content is published. During that change, some of the text was removed from the home page, but the structure and content of all the other pages in the Language Reference were left as they were.
I fail to understand how you can interpret the removal of the sentence "The Arduino language is based on C/C++" from the reference home page as "trying".
There's a link on the page for recommending documentation changes. Maybe that would be a good location to make recommendations.
I'm well aware of this. I'm the top contributor to the
arduino/reference-en repository and the lead maintainer of the project. But I'm glad you brought it up because I would love to see more of the Arduino community take advantage of this excellent opportunity to collaborate on such important documentation. There is a tutorial here:
https://create.arduino.cc/projecthub/Arduino_Genuino/contribute-to-the-arduino-reference-af7c37I would suggest you limit the suggestions to focus on beginners to make this acceptable.
This is the sole documentation of the Arduino programming language. It needs to provide for the needs of all users, not only beginners. Making things beginner friendly is essential, but the goal is to help people eventually progress beyond the beginner stage. Too often in technical subjects I see these knowledge gaps that can be such a huge barrier. I think the attitude people have is "someone will tell you about that". That someone would traditionally be a professor, mentor, or coworker. But the people who are teaching themselves these subjects often don't have access to the gatekeepers who judge whether they're worthy of receiving the secret knowledge that allows them to move to the next level. Maybe they'll be able to sort through mountains of garbage on Google until they find that information buried in some random comment thread, maybe they won't. The only purpose of a system like that is to prevent anyone outside the inner circle of universities and industry from gaining proficiency. Arduino is about freeing the knowledge to make this stuff accessible to everyone. That means providing proper documentation.