The True Value of Documentation

What if the goal of writing documentation was not to accurately describe a system? How it works, how to use it, etc. What if, instead, the goal was to describe how the system should work? Surely, it can’t be right to treat documentation like a fantas...