Chatis the point - it should be lost to the wind. I have never seen design documentation worth reading except in textbooks where it is only used to explain pattens to students.
Right, and my point is that this stuff genuinely matters and is worth recording - but needs to be recorded with a very clear timestamp (hence my preference for comments in a GitHub issue or PR).
Otherwise you'll inevitably find yourself re-litigating old decisions because you never recorded WHY you chose one approach over another.
