And by that, I don’t mean giving away the keys to the store. Keep the “how you build it” stuff to yourselves. What you should do is produce a document that contains something like a “Theory of Operation” section.
One of the best examples of this may be found in vehicle repair manuals. Many of these contain Theory of Operation information. And I am one one of those who is often in the position of being “new” to a subject. Because of this, I really appreciate when a manufacturer includes this tidbit of enlightenment.
From a truck service manual:
“Control Systems for Differential Lock“
“Two systems may be used to control the differential lock operation.
Transmission Low Range Interlock Control System
The wheel differential is locked manually with the transmission
in Low Range. It is unlocked by the driver or unlocked when the
transmission is shifted out of Low Range.”
You should always have at least one Theory of Operation (or similar) section in your docs. This will quickly bring your readers up to speed! And this, will pay back later. You can expect fewer support calls, easier training, and happier service people.