why
-
✨ Impressive is not always effective
When AI generates something, the result is often “impressive.” We might marvel at how quickly lots of code is generated that mostly works. Generated documentation is extremely detailed and well formatted. AI-created diagrams are colorful, u…
-
📚 Without docs
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 nece…
-
📝 Document "why" not "how"
Be kind to others (and your future self) and document why you did something. AI is pretty good at generating the “how” any time you need it, but only you know the “why” because you have that context.