I would like to see a diagram of the required components and optional components. Supported OS versions, core components such as docker (along with version info); watchdog, dashboard options, etc. As someone who is familiar with mining in general, it has taken a while to read through the forum to understand the bits and pieces and how it all goes together and what are the caveats, such as the problem of using multiple HDDs when not in a RAID array and how your public IP affects your ability to mine (more nodes do not equal more mining income).
I also noticed that there is no real centralized document for common SNO technical tips. For instance, running Ubuntu Linux should I update the OS and components such as docker on a regular basis? What amount of downtime is permissible, what is the best way (from an SNO perspective) to bring down a node for short maintenance?
A running list of release notes for each version/OS would be of value.
And most important more accounting for SNO payouts, current and historical, both in terms of tokens and $USD values. Current systems like Etherscan and supportXMR offer great examples of tracking payouts in a distributed system.
I was watching the video yesterday of how to set up a node on windows. And I noticed a few things. The documentation has become really extensive and complete.
That has two sides though. For one, it holds your hand much better and people are less likely to make a mistake if they go through it carefully. But the other side is that it seem like a herculean task to get it up and running. Especially for those who are already quite knowledgeable about many of the concepts.
It would be nice to have a simple guide that takes you through the necessary steps without all the extras. I made an example for Docker installs. More info links at the end of each step still link to full documentation in case the step isn’t clear. Some steps will be obvious to some users, like port forwarding. And some can even be optional, like if docker is already installed or you already have an ethereum wallet. This format allows you to easily skip over those. I also started with identity generation, as that can take a while, so starting that first, while you set up other things makes sense.
When step 3 is done, sign the identity with the token you should have received in your email after signing up in step 1. Replace the placeholder including brackets<> with the token from the email. (more info) identity authorize storagenode <email:characterstring>
Start the node. Replace the placeholder including brackets<> with your info. (more info)
Comprehensive, single source for API documentation and possibly even some of the debug output (storage node port 7777).
Trying to build out external applications for SNOs for monitoring or external information processing can be tedious. Having to search through the forum as most of the time any changes are only included in the release threads, so trying to figure out what is current and what has been obsoleted is a huge pain. No sense in having and maintaining an API if it’s not moderately documented.