๐Ÿ“š Without docs

2025-09-12  ยท  documentation, engineering, design, why, process

Design files (mechanical, electrical, or software) contain the technical details that allow us to manufacture something in the moment, but they often don't contain the "why".

  • Why is this mechanical feature present?
  • Why is this circuit necessary?
  • Why is the code structured this way?

Most designs exist this way -- without adequate documentation. What happens two years later when something quits working? What happens when a new feature needs added? What happens when someone leaves?

World-class engineering requires world-class documentation. There is no other way.