2021 Sep 19, 07:52 PM
Hi Gerard,
Your documentation looks good so far.
The audience of SIP users is quite broad. About the only thing they have in common is that they are people who are building some sort of irrigation related system. Some are knowledgeable about electronics or software development but some are building a system out of necessity and may have limited technical knowledge and perhaps limited English skills.
I try to keep documentation as self explanatory and simple as possible. One strategy I have used is to first list the steps of what needs to be done and then go into detail for each step. That way an experienced user can get a quick grasp of the procedures and a novice will have as much information as they might need. No one has ever complained about the documentation being overly simplified.
I want to thank you for the work you are doing on this project. It is the sort of thing that will make using SIP quicker, easier less expensive, and simpler for many users around the world.
Dan
Your documentation looks good so far.
The audience of SIP users is quite broad. About the only thing they have in common is that they are people who are building some sort of irrigation related system. Some are knowledgeable about electronics or software development but some are building a system out of necessity and may have limited technical knowledge and perhaps limited English skills.
I try to keep documentation as self explanatory and simple as possible. One strategy I have used is to first list the steps of what needs to be done and then go into detail for each step. That way an experienced user can get a quick grasp of the procedures and a novice will have as much information as they might need. No one has ever complained about the documentation being overly simplified.
I want to thank you for the work you are doing on this project. It is the sort of thing that will make using SIP quicker, easier less expensive, and simpler for many users around the world.
Dan
<p><br></p>