docs icon indicating copy to clipboard operation
docs copied to clipboard

In getting-started, it's too hard / not obvious how to move through the guide

Open dmiddlecamp opened this issue 8 years ago • 1 comments

Visually it's not clear that I should click on the 'left' or 'right' arrows, and I can't easily tell where I am in the process

https://docs.particle.io/guide/getting-started/start/electron/

lots going on, hard to get oriented screen shot 2017-08-08 at 9 17 24 am

dmiddlecamp avatar Aug 08 '17 14:08 dmiddlecamp

It didn't occur to me that the Getting started was a Wizard style thing that I should be clicking through, I was expecting something (a but green next button) at the bottom of the page to tell me what the next step is, likewise the way the pages are broken into section suggests they are separate topics such that it's not obvious it's a work flow.

For an Electron the link you need is under "Connecting over USB", as an experienced user I know that's not what I want to do, and even as a beginner I'd probably be expecting to connect over cellular.

I did eventually find the "if you're using an Electron, please follow the instructions" section right at the end of Connecting over USB -> Using Windows, which was the last place I'd ever have expected to find it and somewhat frustrating to have to have gone all the way through the help to get that.

It's mighty confusing have gone from the /Start page, selected the Electron to be having to carefully read documentation to get the device up and running.

BookSwapSteve avatar Aug 08 '17 14:08 BookSwapSteve