Yet another thing that I absolutely hate with ever fiber of my being.
Imagine spending a week or so working on a simple problem. So simple, in fact, that it is deceptively complicated, with a ton of edge cases to consider.
So, you finally arrive at a viable solution. You write everything down, you spend a day or so thinking further about your solution, and after all that time, you're finally happy with it. HURRAH!!
So, you start to document it as an ADR. You get about 25% of the way through the documentation, including all the variables you need, the state tables, etc.
Then, it strikes.
You think of a simpler approach.
And now you have a conundrum: do you start everything all over? Or, do you continue to write what you currently have (and maybe follow-up with another ADR that replaces this one)?
Engineering is hard. Let's go shopping.
@vertigo This is one of the most fascinating aspects of the human mind to me. I enjoy stewing over a relatively difficult problem for a while in various states of mind(no drugs, maybe a few beers) and then BAM a solution presents itself. I've written spaghetti code while nodding in and out of sleep that made absolutely amazing solutions in a few lines and I had no idea what I was looking at the next day. That kind of thinking can't and shouldn't really be rushed.
@daniel Yep. I've decided to complete the documentation of my idea for posterity sake. I'll obsolete that ADR with a new ADR containing the simpler idea within a few days. That way, I'll have a material record of the thought process.