This is a very important aspect of getting people to understand your software, and its even more important to do this when your software does something that people haven't had experience with before.
When I was developing products for OnForce, we tried to do this as completely as possible. The software is an online marketplace for managing on-site IT service (when you bought a service, like a wireless router installation, from CompUSA, for example, it was an OnForce technician actually doing the work).
You can see some examples of this in our product blog.
One thing we found was that writing clearly, simply, and directly is really hard. It takes a lot of work to express software and process (yes, we made the software as simple as we could) in an easily understandable manner.
by Dana Spiegel — Mar 20
This is a very important aspect of getting people to understand your software, and its even more important to do this when your software does something that people haven't had experience with before.
When I was developing products for OnForce, we tried to do this as completely as possible. The software is an online marketplace for managing on-site IT service (when you bought a service, like a wireless router installation, from CompUSA, for example, it was an OnForce technician actually doing the work).
You can see some examples of this in our product blog.
One thing we found was that writing clearly, simply, and directly is really hard. It takes a lot of work to express software and process (yes, we made the software as simple as we could) in an easily understandable manner.