Software: Document WHY

Most important missing document information.

Photo by Annie Spratt on Unsplash

The most important documentation on a system is not in all of the standards for documentation production. What people need is *Why* a particular option was selected. You will have forgotten the reason and be too scared to introduce more problems.

Why were certain paths discarded and this one chosen? Later you may find problems that require a change in…