You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The getting started guide in the docs should be the golden path to get up and running with developing using a device on balenaCloud. We have other getting started guides but this one is specifically a guide to getting up and running with development.
Things to consider and approaches to take:
Create one definitive path from start to finish
Avoid distractions - the path should be clear without forks requiring the person following to make a decision they aren't yet informed enough to make
By the end of the guide the user should have a fleet, a device, an initial release, have pushed an update and know how to develop in local mode. They should be developing (i.e. editing source code and pushing changes) and know how to continue from here on their own.
At the end of the guide give a clear path to continue, don't just give a load of options
Remove troubleshooting notes and put them out of the flow of the getting started guide somewhere else in the docs (if we don't have them already)
I'm not sure the item about giving a clear path to continue is still relevant if we've moved the development flow to the getting started guide. We've shown the user everything we wanted to at this point so to a certain extent it is up to them where they go next. 🤔
The getting started guide in the docs should be the golden path to get up and running with developing using a device on balenaCloud. We have other getting started guides but this one is specifically a guide to getting up and running with development.
Things to consider and approaches to take:
Reference: Alex uses balena notes
The text was updated successfully, but these errors were encountered: