There's not just one person working on this. There are multiple people, working on multiple projects. The fact that a beta launches for a specific part of the ecosystem doesn't mean the rest gets neglected.
I get how teams work, but when there are major issues with components of a given system generally you pool your resources, and documentation isn't so much the issue that I am focusing on here, it's one of them, but I wouldn't rank it as high as UX and error feedback and initial experience.
I have been here since the kickstarter, and this experience was stellar for a little kickstarter project, but we aren't that anymore and there are less excuses for simple fixes like this going unfixed.
Even then, they sufficed to get a noobie up and running.
I understand this mentality, but what I think we are missing is that Particle effectively stands on the shoulders of the Arduino movement. Arduino, while obviously FAR less feature rich than Particle, is stable and starting out is simple. If Particle is going to continue to thrive they can't ignore what started all this.
I actually liked the docs that we started out with, I didn't see the problem with them, if anything lately (after having to go look for Particle Functions again recently) they are actually worse off than they were.
but I just wanted to point out the situation isn't as bad as you may think it is.
Reading what I said is probably important, I am telling you I have had problems with 60% of my initial interaction with these devices. Were my experiences translated to a grade for Particle's "Getting Started" it would be failing by definition.
"Someone please fix the docs" is a bit too broad of a plea to act on unfortunately.
Not to be insulting, but when a user posts here don't do this... If you are quoting, then quote, but don't change the argument in doing so. You are taking what I said and removing the context. I saw a bunch of folks do this to a newbie the other week voicing his frustration, this isn't helping the community.
This is not a focus on the Docs, I brought up the other issues I am seeing in the first post (and if you noticed I made reference to my other recent posts on other issues). Some of these problems don't even take a line of code to fix, this one obviously does, but others could be alleviated with the simplest of design / user considerations.
It's just really frustrating, and I am not a newbie. Having to remember all the stuff I have to do just to get one of my devices online is kinda crazy.
- Plug in the Electron via USB to a computer, attach antenna
- Download Drivers
- Download Ming
- Download Particle cli
- Download Particle Dev
- Put the device in DFU mode
- Open the CLI
- Login to Particle Cloud
- Run: particle update
- Start activating the Electron
- Goto particle.io/start
- Look around trying to figure out how to activate the device
- Find SIM activation on a page titled "Connecting over USB"
- Try and activate, go to setup.particle.io (why isn't that particle.io/setup ? ok whatever)
- Spinning logo, nothing happens for 10min
- Refresh page, try again, wait another 5 min
- Repeat ad nauseum for the next 20 min
- Start googling for errors
- Finally find https://docs.particle.io/support/troubleshooting/common-issues/electron/
- No mention of the simplest and quickest solution "Try activating in another browser"
- Open FF, Activate SIM
That's the process to get the Electron working, and it's kinda terrible. It takes an hour, for a non-newbie, an hour? I have been hamfistedly writing code for these since they came out over a year ago, and it takes me an hour to get one off the ground?
I can't even imagine a newbie starting on an Electron, and maybe that's not the target. I mean, I hope it isn't the target at least. If it was then this would take days if not weeks just to start writing code as someone just starting out. If that isn't the target market then fine I get it, but shouldn't it be? Is the Particle market only looking at seasoned Arduino folks and not the general population as a whole?