Go Down

Topic: Arduino Cloud Docs (Read 662 times) previous topic - next topic

johnwargo

I'm trying to figure out the Cloud platform. So far, I can see that you pick a board, identify some output values from the sketch, then load it on a device. I can't find any documentation for what happens next. the editor isn't working for me, so I can't download the sketch to the board.

I'm assuming there's some sort of place where I can view and/or access the data uploaded to the cloud from the board/sketch, but I can't find anywhere that says that.

So, with that in mind - do you need help with the docs?  I've written 7 books and a bunch of magazine articles, I'm happy to write docs if you need them. I couldn't find another way to offer my help, so here I am.

pert

#1
Aug 23, 2018, 02:57 am Last Edit: Aug 23, 2018, 02:58 am by pert
I've never seen any documentation on Arduino Cloud. It's been around for a long time but is still considered in beta and it seems like barely anyone uses it. Its forum section has very little activity.

I can tell you that Arduino absolutely needs a lot of help with all their documentation. Sometimes the Arduino team is very responsive to suggestions. Other times simple, obvious, non-controversial fixes take years. I've had a lot of success working to improve the documentation but it can be frustrating at times. You just have to give it a try and hope for the best.

From the title of this forum section, you might think that an Arduino employee would monitor it, but this is not the case. If you want to contribute to the Arduino Cloud documentation you will need to open an issue report on the arduino/Arduino repository on GitHub:
https://github.com/arduino/Arduino/issues
Since that's the repository for the desktop Arduino IDE, that might seem like a strange but such is the way of Arduino. They did recently create a dedicated repository where you can submit proposed fixes for documentation but that is limited to the Arduino Language Reference pages only (which is only a small fraction of the Arduino documentation):
https://github.com/arduino/reference-en
That repository provides a much easier and efficient way to contribute to the Arduino documentation so if you are looking to help with documentation in general, rather than Arduino Cloud specifically, you might start there. There is plenty of room for improvement in the Language Reference.

Personally, I'm not interested in contributing to Arduino's closed source projects. I'd much rather put my limited volunteer time to open source projects that are truly of benefit to the entire community.

One issue I see often with the Arduino Create tools is a fundamental problem of terminology. Arduino Create is a web-based platform that consists of multiple parts:
  • Arduino Project Hub
  • Arduino Web Editor
  • Arduino Cloud
  • Arduino Device Manager

It's confusing because it's common to see the Arduino Web Editor called "Arduino Create" and all that stuff is in the "cloud" so that word gets used for more than only specifically Arduino Cloud

ballscrewbob

#2
Aug 23, 2018, 05:45 pm Last Edit: Aug 23, 2018, 05:47 pm by ballscrewbob
Just a quick aside to Pert's notes.

The HUB is actually an affiliation between ARDUINO and HACKSTER who have thier own teams in place.
It is primarily an MCU based instructables.

Web editor AKA CREATE is Arduinos own cloud based IDE. It is under constant development with what I can only describe as "aspirations to become a full IDE" and is limited by some aspects but has a huge user base.

Cloud I think was supposed to be along the lines of some of the other IOT offerings but as Pert says does not seem to get as much attention on development as maybe it should or could.

Device Manager is a quite interesting development that allows interaction between CREATE and other boards of NON Arduino origin.

Each section does to a small extent rely on the others. Overall they are a collection of tools that one day may just become useful as a single entity with users picking what they need to accomplish a task.

Feel free to contribute where you can especially with Pert's ideas for direction of your skills.
We are almost all just volunteers.

Note for Pert.

Not sure if you noticed but there are some relative new users in some sections who are ARDUINO people.
Looks like they are just starting to filter in to the forums and find thier feet and hopefully that trend will continue.
If they are as receptive as the CREATE team things could be looking up.



It may not be the answer you were looking for but its the one I am giving based on either experience, educated guess, google or the fact that you gave nothing to go with in the first place so I used my wonky crystal ball.

Go Up