Hi,
Firstly, if you need assistance in writing technical documentation for end users, this is something I've done my whole career in the IT/carrier network space. I can assist - this is nothing new.
While video documentation that explains things extremely slowly and in excruciating detail is great for the complete novice, its not appropriate for a user wanting information quickly.
For example, Updating firmware on G3 requires me to resort to a video to find the folder name I need to create on the flash drive as well as the hotkey (F1) when booting up to get into the firmware loading mode.
I would request that documentation in the written/picture form be improved and written with the view of the user having basic competence using a computer, a keyboard, mouse, the Masso UI. Think of this like a reference for someone that has a machine up and running and mostly knows what they are doing, but needs to find information on something specific quickly (without watching long winded videos).
Something that is missing from your docs that is fundamental is a single document laying out the complete pinout of the Masso and their functions, properties, and limitations (ie the pin's function, voltage/current limits etc). This information is currently fragmented everywhere some in your written documentation and most in videos. As an example something completely missing is the labeled pinout for the spindle motor control terminal. I had to look at wiring examples for a number of different possible usage options to find the information I need, instead of looking at a single diagram that labels and describes each pin.
Further to this, documentation should be clear and differentiate between G2 and G3 controllers if you do plan to support both. Right now there is information that is written that references G2 that is necessary to get things working on G3, but the G3 is slightly different - enough that the documentation can be confusing to someone without the ability to interpret and take an educated stab.
Firstly, if you need assistance in writing technical documentation for end users, this is something I've done my whole career in the IT/carrier network space. I can assist - this is nothing new.
While video documentation that explains things extremely slowly and in excruciating detail is great for the complete novice, its not appropriate for a user wanting information quickly.
For example, Updating firmware on G3 requires me to resort to a video to find the folder name I need to create on the flash drive as well as the hotkey (F1) when booting up to get into the firmware loading mode.
I would request that documentation in the written/picture form be improved and written with the view of the user having basic competence using a computer, a keyboard, mouse, the Masso UI. Think of this like a reference for someone that has a machine up and running and mostly knows what they are doing, but needs to find information on something specific quickly (without watching long winded videos).
Something that is missing from your docs that is fundamental is a single document laying out the complete pinout of the Masso and their functions, properties, and limitations (ie the pin's function, voltage/current limits etc). This information is currently fragmented everywhere some in your written documentation and most in videos. As an example something completely missing is the labeled pinout for the spindle motor control terminal. I had to look at wiring examples for a number of different possible usage options to find the information I need, instead of looking at a single diagram that labels and describes each pin.
Further to this, documentation should be clear and differentiate between G2 and G3 controllers if you do plan to support both. Right now there is information that is written that references G2 that is necessary to get things working on G3, but the G3 is slightly different - enough that the documentation can be confusing to someone without the ability to interpret and take an educated stab.
